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: eos WSs Fei, aa aS ‘Sé What's on 

- Giigen fee aK ae =< sye=6r The Best of CoCoOz #5 

SINE Nad SO eee =f. eae ADV 32K/16K ..... 0000s S. RAYNER 

; (Restore a nuclear power plant) 

ORBQUEST .......04- TONY PARFITT 
(Save your people from evil!) 

LABYRINT ......... JAMES RAYMOND 
(Try to get out of this one!) 

ADVENTURE + ........0. SEAN HOVE 

(Find wealth!) 

QUEST .... cee eee C&K SPRINGETT 
(Seek out the 3 crystals.) 
PRISON 2... cee eee eee TIM ALTON 
(You gotta get out, see..) 
Ferd 5 abo) OPALTON ........eeeee TAN CLARKE 

=e Br pS ae MUR (A mining adventure. ) 

esi 1) SE ies WIC WIZSOC wi. cece eee DARRELL BERRY 
eo , (Get free before time runs out!) 
TREASURE ....... C DAVISON ET AL 
(Find the Warlock's possessions? 


PRICE Tape $10.00 
Disk $16.00 


NOTE: Most of these games 
are 32K or 64K. 





GOLDSOFT. P.O. BOX 1742, 
SOUTHPORT, 4215. 





Computer Hut Software 


Music Box ......... seveececs . Tape only $34.95 
Learn to Read Music ...... Tape or Disk $33.95 


CoCoTex .u..ccccccssceeees Tape or Disk $79.95 
Use your CoCo to contact Goldlink on Viatel. 


Special!! 


64K upgrades for SOME CoCo’s ......... $40.00 
Phone or message us on Viatel for details. 


T1000 Games: 


Sea Search .........ccceeesceeceeess $49.95 

Shenanigans ..........cccceecsesesees 949.95 

See us on Goldlink this month! 
sfiiiilo'” = VIATEL NUMBER | Smit Ms frdare" 
| * UISACARD 642624 Phone (O77)86-2220 


ALL ORDERS SHIPPED SAME BDAY 


CPA-80(S) $522.96 
CPB-80(S) $554.38 


PERIPHERAL PRINTERS 
IDEAL FOR CO-CO 


@100CPS CPA- 80 (S) @130CPS CPB - 80 (S) 

@ TRACTOR/FRICTION PAPER FEEDER STD. 

@ WITH SERIAL RS 232 C/CURRENT LOOP. 

@ DATA TRANSFER RATE - 75, 110, 134.5, 150, 200, 300, 600, 
1200, 1800, 2400 AND 4800 B.P.S. - PROGRAMMABLE. 

@ SYNCHRONIZATION - ASYNCHRONOUS 

@ HANDSHAKING - FLAG CONTROL X-ON/X-OFF PROTOCOL. 

@ LOGIC LEVEL - EIA LEVEL (RS 232 C) 20ma CURRENT LOOP. 

@ SOCKET PROVISION FOR USER FITTED 4K BUFFER (USES 6116) 

@ SERVICE MANUALS AND SPARE PARTS AVAILABLE. 


SPECIAL OFFER — WHILE STOCKS LAST 


@ DUAL DISC SYSTEM FOR CO-CO 
DUAL SINGLE SIDED DOUBLE DENSITY DISC DRIVES. 
CONTROLLER CABLES. 

CASE POWER SUPPLY AND MANUALS DOS & ROM 

@ SINGLE DRIVE SYSTEM FOR CO-CO 
ONE DOUBLE SIDED DISC DRIVE (CASE HAS SPACE 
FOR 2 DRIVES) OTHERWISE AS ABOVE 

@ DISKETTE SPECIAL 
DS DD GTR BLK PK25 
CLUB OR SCHOOL BUY 


$499 inc. Tax 


$449 inc. Tax 


$2.14 ea inc. Tax 
200 $1.95 ea inc. Tax 
800 $1.85 ea inc. Tax 
PRICES VALID WHILE STOCKS LAST — OTHERWISE 
SUBJECT TO EXCHANGE VARIATION. 


enelou 


CONTROL 


ENERGY CONTROL PTY. LTD. 

P.O. BOX 6502, GOODNA, QLD. 4300 

BRISBANE, AUSTRALIA. 

PHONE (07) 288 2455 

TELEX AA 43778 ENECON 

PHONE WELLINGTON N.Z. (64) 843 499 
W.A. (09) 325 5722 


ajax 


FOR THE RACING ENTHUSIAST 


FRAME YOUR OWN MARKETS 


Whether you spend hours 
or just minutes doing the 
form, you can use this 
fully documented program 


32KECB 
tape only 


Ajax an 
Box 103 
Adelaide 5001 


ph.(08)382 0045 


MK 1 SERIAL/PARALLEL 
PRINTER INTERFACE 


CONNECT CO-CO I or II to a PARALLEL PRINTER 
Revised MK! PRINTBR INTBRPACE 
Features: 
® EXTRA SERIAL PORT for MODEM,no sore plugging 
/unplugging cables. 
Compatible with Standard Centronics Parallel 
Printers eg: BPSON ,GEMINI,BMC,CPS8O,TANDY ETC. 
Plugs into CO-CO or CO-CO II Serial Port and 
includes all cables and connectors. 
SIX Switch selectable Baud rates 
300, 600, 1200, 2400, 4800, 9600 
Power Pack is required for Printers not 
eupplying power at pin 18 on the Parallel 
Connector eg: BPSON,BMC,CPS8O. 
Increases Printing Speed by up 
to 30% on TANDY DMP100/200 Printers 


NOW ONLY — $89.95 (including postage) 
Add $9 for Power Pack if required 


AVAILABLE FROM: G@.& G. PIALA 
P.O. BOX 46 
THORNLBIGH. NSW.2120 
phone: (02)-84-3172 


Hardware! Software 


Specialists 
For All Your CoCo Needs 
AUTO ANSWER $399.00 


INFO CENTRE 


THE FIRST BULLETIN BCARD SYSTEM 
Tolan k= laleh mas torolaalenenecias 


(02) 344 9511 — 300 BPS (24 Hours) 
(02) 344 9600 — 1200/75 BPS 
CN itclae lolelasmOlain’a 


SPECIAL! 


Avtek Mini Modem + Cable + CoCo 
Tex Program — the total Viatel System — 
$279.00 


We also have the largest range of Software for 
OS-9 and Alex operating systems. 


PARIS RADIO ELECTRONICS 


16] Bunnerong Rd, Kingsford, NSW 2032 
(O2) 344 9111 








How To Read Rainbow 


Please note that all the Basic program 
listings you find in THE RAINBOW are 
formatted for a 32-character screen — 
so they show'up just as they do on your 
CoCo screen. One easy way to check on 
the accuracy of your typing is to com- 
pare what character “goes under” what. 
lf the characters match — and your line 
endings come out the same — you have 
a pretty good way of knowing that your 
typing is accurate. 

We also have “key boxes” to show you 
the minimum system a program needs. 
But, do read the text before you start 
typing. 

Finally, the little cassette symbol on 
the table of contents and at the begin- 
ning of articles indicates that the pro- 
gram ty available through our RAINBOW 
ON TAPE service. An order form for this 
service is on the insert card bound in the 
magazine. 


What's A CoCo . 


CoCo is an affectionate name that was 
first given to the Tandy Color Computer 
by its many fans, users and owners. 

However, when we use the term 
CoCo, we refer to both the Tandy Color 
Computer and the TOP System-100 
Computer. It is easier than using both of 
the “given” names throughout THE AAIN- 
BOW. 

In most cases, when a specific com- 
puter is mentioned, the application is for 
that specific computer. However, since 
the TOP System-100 and Tandy Color 
are, for all purposes, the same computer 
in a different case, these terms are 
almost always interchangeable. 


The Rainbow Check Plus 
WW 


The small box you see accompanying 
@ program listing in THE RAINBOW is a 
“check sum” system, which is designed 
to help you type in programs accurately. 

Rainbow Check PLUS counts the 
number and values of characters you 
type in. You can then compare the 
number you get to those printed in THE 
RAINBOW. On longer programs, some 
benchmark lines are given. When you 
reach the end of one of those lines with 
your typing, simply check to see if the 
numbers match. 


To use Rainbow Check PLUS, type in 
the program and CSAVE it for later use, 
then type in the command RUN and press 
ENTER. Once the program has run, type 
NEW and ENTER to remove it from the area 
where the program you're typing in will 
go 

Now, while keying ina listing trom THE 
RAINBOW, whenever you press the down- 
arrow key, your CoCo gives the check 
sum based on the length and content of 
the program in memory. This is to check 
against the numbers printed in THE 
RAINBOW. If your number is different, 
check the listing carefully to be sure you 
typed in the correct BASIC program code. 
For more details on this helpful utility, 
refer to H. Allen Curtis’ article on Page 
21 of the February 1984 RAINBOW. 

Since Rainbow Check PLUS counts 
spaces and punctuation, be sure to type 
in the listing exactly the way it’s given in 
the magazine. 


10 CLS: X=256*PEEK(3S)+1786 
2@ CLEAR 25,X-1} 
30 X=2S6"PEEK (3S)+176 
40 FOR 2=X 10 X*+77 
S@ READ Y:W=Wt+Y: PRINT Z2.Y3W 
60 POKE 2,Y:NEXT 
7@ IF W=79BSTHENBOEL SEPRINI 

“DATA ERROR™:STOP 
8@ EXEC X:END 
9@ DATA 182, 1, 106, 167, 140, 60, 134 
10@ DATA 126, 183, 1, 106. 19®. 1, 107 
110 DATA 175, 148, 5@, 48. 140, 4, 191 
12@ DATA 1, 107, S7, 129, 10, 38. 38 
130 OATA S2, 22, 79, 158, 25, 230, 129 
140 DATA 39, 12, 171, 128, 171, 128 
150 DATA 230, 132, 36, 250, 48, 1, 32 
160 DATA 248, 183, 2, 222, 46, 148, 14 
178 DATA 159, 166, 166, 132. 26, 254 
180 OATA 189, 173, 198. $3, 22.:126, 8 
190 OATA @, 135. 255, 134, 40, 55 
200 DATA S1, S2. 41, @ 


Using Machine Language 


Machine language programs are one 
of the features of THE RAINBOW. There are 
a number of ways to “get” these pro- 
grams into memory so you can operate 
them. 

The easiest way is by using an editor/ 
assembler, a program you Can purchase 
from a number of sources. 

An editor/assembler allows you to 
enter mnemonics into your CoCo and 
then have the editor/assembler assem- 
ble them into specific instructions that 
are understood by the 6809 chip that 
controls your computer. 


When you use an editor/assembler, all 
you have to do, essentially, is copy the 
relevant instructions from THE RAINBOW’S 
listing into CoCo. 

Another method of getting an assem- 
bly language listing into CoCo is called 
“hand assembly.” As the name implies, 
you do the assembly by hand This can 
sometimes cause problems when you 
have to set up an ORIGIN statement or 
an EQUATE. In short, you have to know 
something about assembly to hand- 
assemble some programs. 

Use the following program if you wish 
to hand-assemble machine language 
listings: 


10 CLEAR20@, &H3F QQ: 1=28HIF BQ 
20 PRINT “ROORESS: ~;HEX$(1); 
30 INPUT “BYTE” :8S8 

40 POKE I, VAL( “8H~+88) 

50 1=!1+1:GOTO 2e 


This program assumes you havea 16K 
CoCo. If you have 32K, change the 
&H3F 0 in Line 10 to &H7F@@ and change 
the value of I to &H7F BQ. 
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VIDEOTEX 
EQUIPMENT 
SOLUTIONS 


Anyone with a telephone can access Videotex and 
Visionhire Business Systems will tailor the hardware and 
software to suit your needs, ranging from an adaptor for 
only $18.00 per month up to IBM's PC of the year,the AT. 
Only the latest equipment from famous brands like IBM, 
Apple, Commodore, Tandata and Sony is used, all 
backed by Visioncare's Australia wide full service 
network. | 
You can rent, buy or lease 
your equipment from 
Visionhire Business 
Systems, the choice is 
yours. 
If you have any questions 
just ask for advice, after 
all, Visionhire Business 
Systems have supplied 
75% of all dedicated 
videotex terminals 
currently in use in 


Sips 





VUSIONHIRE CALLWAY PEELS 


VW ilonnior 


BUSINESS SYSTEMS 


asper CoCo Quick Assembler 


Computer and Business Bankbook 


Tandy Color Computer 3 
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U-Buff ....  cc ee ee eee e ee ee ee eee tee eee ees 15 
Wico Command ...... ccc ccc cee cee cee eee ee eee eee eee eens 16 
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by Greg L. Zumwalt 
by Steve Bjork 
by Ed Ellers 
by Keiran Kenny 


Do It Yourself ... cece ccc ec eee eee eee by Tim McIntosh P 23 
RATTLE CLATTER ..... cc cece eee eee eee by Michael Kromeke P 24 
CoCo Better Again oc. cece cece nen e evens by Lonnie Falk P 26 
CoCo Mouse ..... ccc ec eee eee ete ee ete eee by Steve Bjork 27 
COCO 2B occ eee cece ee ee ee eet eee enne by Tony DiStefano P 33 


by Jeff Harper 
by John Poxon 
by Richard A. White 
by William Barden Jr. 
by Dale L. Pluckett 
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COMPUTER WIZARDRY 


$38 SPECIALS THIS MONTH 888 


TAPE UTILITIES: Hidden Basic, Fast Tape, CoCo Screen Dump 
(for Epsom/Gemini Printers), FPritty Printer (LLISTing 
Formatter), Tape Utilities (Version 1.5), 40K Basic, Frint 
Spooler and ROM Crack (last three require 64K). 


SPECIAL PRICE $29.95 T/D SAVE OVER $60.00 !!! 


DISK UTILITIES: All of the above plus Disk Utilities 
(Version 2.1), CoCo Checker (Diagnostic test program), Fast 
Dupe 2 (Disk Duplicator), Schematic Drafting Processor 
(makes drawing circuit diagrams easy), EZ Base (simple to 
use Data Base), Multipac Crack (put your ROM packs on disk, 
requires Multipac), Spectrum DOS (enhanced disk Basic). 


SPECIAL PRICE $99.95 SAVE NEARLY $200.00 !!! 
LYRA: Speech Systems’ newest music generating program, This 
one does everything you wished Musica 2 did, Send $10 for a 
demo program (free with above specials), Full price: $64.95 


We are agents for Computer Hut Software, Hundreds of 


Australia. titles available. Call or write for a Price List. 
For friendly 
advice ring Prices are current at time of printing and do not inculde 
Will Balischmieter or postage & handling, 
Don Sanderson on 52 5723. 
iSIONHIRE earmcora_ | P.O, Box 979 FAN Panne | 
| IONHIRE Gosford | VISA 
BUSINESS SYSTEMS L N.S.W, 2250 tees 


A Oimon of Vissonhire Ausirake Ply Lid 


36 Brookes Street, Bowen Hills 





Phe O43 247298 


PRINT #—2 





N WEDNESDAY (27/7) we were to get the new 
Color Computer direct from Tandy. It never 
arrived. I was fairly disappointed. I wanted 
to toy with it so I could get a ‘real’ 

impression of it, unlike the impression everyone 
else was giving me. 

Instead it arrived on the Friday night prior to 
CoCoConf. I didn’t get much done that night, 
mainly because I was, as Graham puts it, drooling 
over the new computer. 

You all know about the hardware features the new 
CoCo has; we've told you about them either over 
the phone, on Viatel, in the magazine and word of 
mouth. So I won't bore you with that. Instead I'll 
tell you about the ‘enhanced’ commands the new 
CoCo has. 

The Basic in the new machine is Microsoft 
Extended Basic with enhancements by Microware. 
When you turn it on, you're immediately in the 
all-RAM mode which means that the entire contents 
of ROM (including the disk controller) is copied 
into RAM. (No need to run a 64K program for this 
one.) Anyway, through the night I discovered some 
of these neat-o commands in one way or another. 

The new hi-res screen and graphics (320 x 192 
and 640 x 192) don’t use any more memory in the 
BASIC memory area than they do now. They are 
located elsewhere in memory. In this way, all 
software is still ‘totally compatable’. 

The new commands include HBUFF, HCIRCLE, HCLS, 
HCOLOR, HDRAW, HPOINT, HGET, HLINE, HPUT, HRESET, 
HSCREEN and HSET. You can also print on the 
graphics screen using the following commands: 
HPRINT, HSTAT and LOCATE. You have three screens 
to work with: 32, 40 or 80 colunms using the 
syntax WIDTH 'x’ where 'x' is 32, 40 or 80. 

There are 64 colours to choose from, but you can 
only use any 16 colours in one of the screen 
modes. The commands for these are ATTR, PALETTE 
and CLS. 


New error trapping as well as BREAK trapping 
commands are ON BRK GOTO, ON ERR GOTO, ERLIN and 
ERNO. . 

What we know as the "64K" is located in 


locations $70000 to &7FFFF. So to access other 
memory locations, you have to use LPEEK and LPOKE. 
This means that doing a PRINT PEEK(O) returns’ the 
Same memory value as does LPEEK($70000). LPEEK and 
LPOKE allow us to access memory locations outside 
the normal 64K address space. 

For those with the deluxe joysticks (with two 
buttons) the new CoCo serves a purpose 
The BUTTON command can be used to read each of 
four fire buttons; two on the left and two on the 
right. 

While I was there, I tried a few DOSes that were 
lying around the place. RS-DOS 1.0 & 1.1 work 
perfectly, even though the power-up message 
doesn’t register 1.0 or 1.1 DOS. The Rainbow Bits 
DOS 1.3 or 1.4 won't work. Apparently when they 
designed the 1.3 & 1.4 they used the tokens that 
the CoCo wasn't using then. 

In the OS-9 field it supports functions like 
windows and a whole lot more. See the article in 
this magazine on windowing. 

But the CoCo 3 has new commands and therefore 
must have new tokens. So when you load a program 


as well. 


with 1.4 DOS using the CoCo 3, you get commands 
like DOS 1,4 (when it should normally read ATTR 
1,4). 


All in all, it's a nice machine to work with and 
well worth the money. Normally machines with such 
functions cost around about $1500 to $2500. This 
new CoCo is merely $449! 


CoCoConf 

CoCoConf was held on the weekend August 30-31st. 

It was a great success. About 130 people attended 
and all of us had a great time. Compared to last 
years Conference, we had twice as many people 
attending with half as many problems. This was due 
to the fact that we had a lot more people helping 
out. Most of them were volunteered, and others 
volunteered. (There is DEFINETLY a difference in 
the last phrase. ) 

The people we 
out are: 

* Maurice Phillips: Played security guy Fri & 
Sat. nights with me setting up the tables & 
chairs to later get wrapped all night in the 
graphics abilities of the Atari 5205ST. 

*k Andrew White: Was the games player, waiter for 
those who stayed up Sat. night & sort-of made 
a fool of himself. 

* Andrew Simpson: stayed back Sat. night to 
see what’s new as well as play games who then 
afterwards left his jacket behind. 

kK Rainer Horn: Guy with the camera standing 
from a distance taking photos of embarressing 
situations as well as bringing along the model 
train to display the usefulness of the 
CoCoConnection. 

* Michael Horn: Another one who stayed back part 
of Fri night to see 'what's new’ just to find 
out that he was getting us dinner at 3 in the 
morning. Another you can blame for taking 
photos. Also, he gets a mention for best stunt 
scene. You see, he nearly totaled his car to 
get to CoCoConf on Saturday Night. (Talk about 
getting involved! Gee!) 

* Annette Morphett: Sales woman who tried hard to 
sell the stuff we've been selling you lot for 
the past year. 

* Julie Vidler: The good-looking one that sat 
behind a table most of Saturday giving out 
name tags. 

* (Qne who remains anonymous): Helped in bringing 
computers back from the conference to end up 
getting a ticket for crossing a red light. 
(Hiya Rob!) 

x Tony Evans: Guy from Computer Hut Software who 
has the largest range of software for the 
CoCo. He's another one who got booked, I hear, 
for doing 145 KPH going home from the 
conference. 

* Lots of other people that can’t be named here 
otherwise we would have a whole magazine of 
thanks to those who helped. 

k Seagulls: They fed us and had to put up with us 
bunch for the whole weekend along with those 
people who watched their football team lose. 
(By the way, the score was 0 for Seagulls, 24 
for the opposition, whoever they are.) 

* Graham: (I'm going to mention him even though 


would like to thank for helping 
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he doesn't want me to...) He’s the one you 
should blame if there was anything you didn’t 
like. You see, he organized most of it. 


My basic role there was to stay up all Friday 
and Saturday night and watch over the computers 
with Maurice. Over the 2 - 3 days we got about 5 
hours sleep. That’s why the few who saw us at 
CoCoConf, saw us staggering around like Zombies. 

Either way, it was a lot of fun! 


Programming Competition 

There were so many games & utilities that we (or 
rather I) spent 3 full days going through all of 
the programs to see how they measured up. For 
those which did, I had to then pick one of three. 
Graham then chose the best one. 

To see who won and why they won, see the article 
about the contest in the following pages. 


The Future 

Seeing that I edit this magazine, I feel that 
there should be more Australian material put into 
the Rainbow. I also feel that the Australians can 
do a lot better than some of the stuff that the 
Americans are putting out. 

So the bottom line is that we are going to put a 
lot more Australian material into the Rainbow than 
previously. We find that there is a lot of 
technical information and material in the office 
that, really is inappropriate for Australian CoCo. 

Australian CoCo is a magazine for the beginner 
and novice. Australian Rainbow is a magazine for 
semi-/experienced programmers & hackers seeking 
advice on what other things they can do with their 
CoCo. 


STOP GLARE | 


Ever tried to de-bug your screen of Glare and Reflection ! 
Can't, can you? TELEMAT Anti-Glare sprays for Computer and T.V. 
screens can. Developed and manufactured in Australia to combat this 
very problem. It will reduce Reflection and Glare by up to 94% and will 
also solve the problems of eye strain and headaches. TELEMAT is 
available in VDU monitor Amber, Green, Neutral and TV Neutral. It is 
applied in a spray form and application is carried out by trained 
technicians. The coating has an indefinite life span and is guaranteed 
for 3 years. The coating is very durable and will not show fingerprints. 
Average coating time is approximately 10 to 15 minutes per unit. It can 
change a normal black and white VDU into an Amber or Green unit. 
To maintain the coating, we use as part of the process, and recommend, 
TELEMAT ANTI-STATIC POLISH. The coating has no detrimental 
effect on the screen or unit and can be removed very quickly if required. 
This form of Anti-Glare treatment is being used throughout Australia by 
large corporations right through to the home user. The product has been 
independently tested by the Queensland Institute of Technology and 
these results are available on request. 


For more detailed information write, 
TELEMAT Anti-Glare Pty. Ltd., 

3 Fortril Drive, Springwood, 

Qld. 4127. or Phone: (07) 208 3557 


In the Rainbow, we have material like hardware 
modifications, other computer languages, advice, 
utilities, etc. 

I would like you computer experts to get that 
high-level stuff in here! Let’s show them Yankees 
something! Let's see who's more capable! 





y GOLULN Ih 
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B92 on VIATEL 
DISTRIBUTORS 


Distributors are required in all states throughout Australia for a recently 
developed product designed to combat the problems of reflection and 
glare on Computer and Television screens. This form of anti-glare is a 
proven product and is manufactured in Australia. The low initial 
purchase price for the distributorship and the extremely attractive 
returns make this a very viable proposition to an individual or company. 

There is unlimited sales potential in the Australian market. Initial 
assistance in setting-up is provided and on-going aid etc assured. 


For further details write to TELEMAT Anti-Glare Pty. Ltd. 
3 Fortril Drive, Springwood, Qld. 4127 
Phone (07) 208 3557 or N.S.W. (065) 54 1441 
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Wilfred from Tandy examines part of the Graeme Nicholls discusses OS9. 


CoCoConnection system which controls 
this model railway whilst Richard 


Pankhurst and Rob Hillard look on. 





Alex discusses some Advanced BASIC concepts. Graham Morphette with Ken Allen (Tandy). 





Brian Dougan again(! ) 
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Jackie Cockinos (second left) displays 


Ross Eldridge discusses Education & computers. 
Paris Radio's wares. 





Mike Turk discusses BASIC. 


Bob Delbourgo shows how a CoCo can be 
used for research. 





CONTEST 
WINNERS 


At CoCoConf, the prizes and awards for the year were 
presented. 

This year a number of the actual recipients were 
present, so it was nice to be able to present the 
awards personally. 

The Greg Wilson Award for Services to the Tandy 
Computer Community went to Brain Dougan & Family. 

Brain was one of the founding members of the 
CoCo community in Australia & is probably best known 
to many CoCo users as the Author of the definitive 
CoCo utilities Omnikey, & Diskfile. 

He is known to locals as a tireless worker, 
willing to give of his time to the extreme to help 
someone in need. 

Brain has helped people all over Australia with 
often vexing problems & is rarely known to be beaten 
in the solving of these problems - most of the time 
with no thanks or recompense. 

Many is the night that he burned the midnight oil 
doing upgrades & hardware mods for people. He 
virtually pioneered the use of the double sided 
double drive set in one box. 

He was also part of a team which was responsible 
for the development of a first rate CoCo moden, & 
was responsible for several other add on devices 
which rated as well or better than the imported 
products. 

Brain has devoted himself for over three years to 
helping other people, and the award recognises this 
devotion. 

However this award also recognises Brain's 
Family, & the part they have played in support, help 
with projects, and a continual commitment to playing 
host / hostess to a never ending stream of 
visitors. 

The Greg Wilson Award was returned by Bob 
Delbourgo, whose Family won it last year, and, after 
Bob had spoken on the importance of the award, and 
reminded us of the very important place Greg Wilson 
still has in our hearts & in our history, Ken Allen 
from Tandy then made the presentation. 

It came as a complete shock to Brain & family, 
who provided one of the conference's memorable 
moments with their look of surprise! 

To the Dougans we say "Thank You” for everything. 

They receive the Greg Wilson Award trophy which 
stays with them for this year. They also receive a 
keepsake wall plaque. 

Other awards included a number of Special 
Mentions. The Special Mentions are not awarded in 
any particular order or number. However this year 
there were 4 Special Mentions. 

Tom Lehane, like the other three recipients, 
received his award for his continued support. 

In Tom's case, he has supplied programs 


virtually every month since the MiCo magazine began 
in 1983. 

When he purchased a CoCo sometime later, he did 
not forget his MC 10 friends, & continued to supply 
MC 10 programs, plus an increasing number of CoCo 
programs. His programs are oftem definitive, usually 
simple, and always easy for the new users to 
understand. 

Tom received a Probe from Goldsoft and a 
quantity of software from Computer Hut Software. 

Max Bettridge, of the four Special Mention 
recipients, produces the least number of programs 
per year. But even so we get one from him about once 
every two months or so. 

Max's programs are top quality, often machine 
language, programs with an emphasis on excellent 
quality graphics. 

He shows us the potential of our computer, & so 
often is the catalyst for a program by someone else. 

Max lives in Bowral, and programs on his own. He 
has had to learn the hard way, & he is living proof 
that with a CoCo, isolation is no barrier to gaining 
a high level of computing skill. 

Max received a Probe from Goldsoft, a Koala Pad 
from Tandy & some software from Computer’ Hut 
software. 

Steve Youngberry is also in a small town... 
smaller in fact than Bowral. 

Steve lives in Tara, Qld, 
recently has worked alone. 

Steve produces consistent quantities of quality 
medium to hard level Basic programs, usually with a 
graphics bent. 

I can't speak too highly of this man, who like 
the other recipients is a very humble man who “is 
just doing what he enjoys”. 

Steve received a Probe from Goldsoft and some 
software from Computer Hut Software and Tandy. 

Soon after we took over the publication of the 
magazines in 1984, the first article I read was from 
a mother of 10 in Forbes. 

I read the article again & again for several 
days. It had a quality about it which has shown up 
time and again in Johanna Vagg’s work... that of 
real down to earth sincerity and concern for others. 

Since that day, she has continued to present on 
a monthly basis, even in hospital when she _ should 
have been giving birth to Katie, articles of 
enduring value to us all. 

Johanna, like Steve & Max, was able to be at 
CoCoConf, and she received an Ears package from 
Bayne & Trembath. 

It was hardly a secret that Bob Horne 


much 


and again until 


would be 


continued on Page 16 
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Software Review 





Innovative Plateau of the 
Past is a Swashbuckler 


After many years and many Adventures, it would take 
something uncommon to really stir my interest. Not just 
another dragon to slay, another cave to explore, another 
300K monstrosity, but... well, something different that 
could really offer an interesting challenge. Something new. 

Enter Plateau of the Past — just the thing to whet your 
whip-cracking appetite. 

Almost as soon as you begin Plateau, you will be 
reminded of Indiana Jones. Rather than a classic text or 
a modern graphics Adventure alone, this Adventure 
combines a little of both. A dash of animation and a 
separate fight screen help add to the challenge and the 
difference of Plateau. This is not aneasy Adventure to solve! 
One nice feature of this program is that authors Chuck Jager 
and Jim O’Keefe have waxed philosophical, and the text 
and gravestones have interesting sayings. Death, my dear 
fellow Adventurers, is no longer boring! 

The program is composed of three major components 
plus start-up routines and so forth. They are the text 
window, generally the lower half of the screen, and the map 
window, a Hi-Res 2-inch by 2-incl area in the upper center 
of the screen. The map window reads like a map from above, 
but displays the moves of the characters in the Adventure, 
as well as your progress, major events and confronted 
meanies. The third screen is the fight screen. It pits you 
against the enemies, displays your and their attributes and 
describes the fights with blow-by-blow descriptions. Fights 
are resolved when one side’s stamina has dropped to zero. 

Several things make the game smoother and more 
enjoyable. These include the compass that charts your 
progress; being able to check your ability, stamina and luck; 
selecting and reviewing your weapons; and even the 
opportunity to eat. The documentation 1s well-written and 
clear and tells you all you need to know. The rest is up to 
you and fate, because luck plays a large part in Plateau of 
the Past. 

Good as it is, I found several drawbacks to Plateau. First, 
there is no game-save feature. It could be argued that one 
is not necessary, however, a save routine would have been 
a nice extra. Second, you must restart the entire Adventure 
each time you die. This is tedious, and a shortcut (save 
routine) would have come in handy. Third, the fight 
routines, while being creative and well-represented, are 
somewhat reminiscent of the sound effects portrayed on- 
screen in the Batman television series. Substituting graphics 
here instead of words would make worlds of ditference. A 
slightly larger map window would have been better, too. 

All of these are minor points, however, when considering 
this extremely well-written, well-presented, innovative 
Adventure program. Plateau of the Pastis a good, rollicking 
swashbuckler of an Adventure to keep even Indiana Jones 
proteges happy for a long time! 

(Zytek, Ltd., P.O. Box 701, Blue Island, IL 60406, 32K disk 
only $26.95 plus $2 S/H) 
— Jeffrey S. Parker 
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Get a Kick from Karate 


Karate is a game for either one or two players requiring 
a 64K ECB Color Computer and joysticks. The software 
is available on either disk or tape, and is copy protected. 

After loading the program, you are greeted with a color 
test screen. Here you are given the opportunity to correct 
the color by resetting the computer. The main title screen 
follows and has spaces to list the top 10 scores. After 
selecting either one or two players, you are ready for action. 

The object of Karate is to knock down your opponent 
using various karate moves, kicks and punches to score 
points. Your points are displayed at the top left of the screen. 
In a two-player game, the first player to win two matches 
is the winner. The number of matches won for each player 
is displayed at the bottom of the screen. In the one-player 
matches the opponent is the computer. 

Action is controlled by the joystick(s) and the following 
karate moves are possible: low kick (trip), forward kick to 
body, backward kick to body, front-punch to head, front 
punch to body, front kick to head, backward kick to head 
and drop kick. In addition to these moves, your man can 
do either forward or backward flips. The moves and 
punches appear authentic. Obviously the programmer, 
Dave Dies, knows something about this popular Oriental 
sport. 

The graphics are really outstanding, and unique sounds 
are used with the score screen. One man has a blue belt and 
hair, while the other has a red belt and hair. 

My only complaint, after learning that the software’ is 
copy protected, is that no mention is made in either the 
documentation or the RAINBOW ads about a warranty. 
Certainly the author has a right to protect his software, but 
he should also tell the customer what can be done in the 
event a problem develops with the program. 

If you are into karate, you will get a kick out of this 
program. But even if you’re not, you will find it an 
interesting game and a pleasant diversion from typical 
computer fare. 


(Diecom Products, 8715 Fifth Line, Milton, Ontario, 
Canada L9T 2X8, tape or disk $28.95 U.S., $38.95 Can. plus 


2 S/H 
52 S/H) — Jerry Semones 


One-Liner Contest Winner... 


According to Francois, rain is rare in Australia so 
he wrote this program to remind his children of what 
it looks and sounds like. 


The listing: 


@ PCLEAR8 : FORS=1T08 : PMODE#,S: PCL 
S: FORR=1TO1LSSTEP2 : CIRCLE (126,94) 
»>R*S:NEXTR,S: FORK=1TO19O 906: FORI= 
1T04: POKE149@,10@+RND(159) :EXEC43 
345:PMODE4,1:SCREENI1,1: FORJ=1TOR 
ND(59) :NEXTJ,1I,K 
Francois Bolle 
Australia 
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Software Review 


OS-9 Utilities Give 
Added Power to OS-9 


One of the nicest things about OS-9 is you are not limited 
to the utilities that come with the package. The Other Guy’s 
Software is offering a package with some interesting and 
useful utilities you just might want to try. 

I received OS-9 Utilities on a disk setup in the popular 
style having the programs located in their own subdirectory 
called /cmds. The utilities supplied in the package are: 
Bmode, changes parameters on random block file managers 
(i.e., disk drives); Calc, a scientific calculator with memory; 
Cat, lists files to the standard output; Cptree, copies all of 
one directory (including any subdirectories) to another 
directory; CP, copies one file to another file; Crypt, 
encrypts/decrypts files; FRS, reads a Radio Shack DOS 
text file under OS-9; Grep, a patterned search routine; 
Hcalc, a hexadecimal calculator; Help, provides help on a 
user-specified topic; Locate, locates all occurrences of a 
specified filename in a specified directory (includes all of 
its subdirectories); Lower, changes all uppercase letters in 
a specified file to lowercase letters; Mkdir, makes directo- 
ries; MV, moves files from one place to another, deleting 
the old file as it writes the new one; RM, deletes a specified 
file or files; Split, splits one file into several files of specified 
lengths; 7F, formats text for display or printing; 7RS, 
writes an OS-9 file on a Radio Shack DOS disk; Upper, 
changes all occurrences of lowercase letters to uppercase 
letters in a specified file; Rsdir, reads the directory of a 
Radio Shack DOS disk under OS-9. 

In addition to these twenty utilities, the package also 
contains three devices. They are MEM, a RAM disk; NUL, 
a null device; QUE, a device for ordering command 
processing 

[am not familiar with OS-9 packaged for applications 
other than the Color Computer. Some of the utilities 
included in the package duplicate utilities that come with 
CoCo OS-9 packages. These are RM, which seems to be 
the same as the OS-9 DEL command, CAT, which seems 
to be the same as the OS-9 LIST command, and MKDIR, 
which does the same job as the OS-9 MAKDIR command. 

All of the utilities ran without a hitch, except Bmode, 
which the documentation warns will probably not work 
with the standard CoCo OS-9 drivers. 

It would be hard to pick one utility over the others. I liked 
several of them. The ones I would use most often would 
be Cptree to copy all the files in a /cmds directory, and MV, 
which allows you to move a file from one place to another, 
deleting the file from its former position as it copies it to 
its new position. 

The only minus mark for this package is for the docu- 
mentation. The package comes with almost no documen- 
tation and the user is expected to get instructions from the 
Help files. The package does come with a three-page 
photocopy of the installation instructions. I solved the 
problem of documentation by loading List into memory and 
then listing each of the Help files to the printer. This gave 
me a pretty respectable set of instructions. 





An unfortunate fact of CoCo OS-9 life is a shortage of 
both disk and memory space. For this reason I would 
suggest that a new purchaser of this package load each of 
these utilities into memory one at a time and then execute 
them to evaluate whether they deserve a spot in the /cmd: 
ctober 
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directory or not. I believe you will find a spot for at leas: 
one or two. 

Of the four qualities I look for in a utility — ease of use 
usefulness, relative freedom from bugs and value for the 
price — this package qualifies on all four. I have alread: 
purchased two of these utilities separately for much mor 
than the price of the entire package from The Other Guy’ 
Software. | 

I recommend OS-9 Utilities without reservation t 
anyone who uses OS-9. 


(The Other Guy's Software, P.O. Box H, Logan, UT 84321, 
$19.95 plus $2.50 S/H) 


— Larry Goldwasse 
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Memory Minder: Insurance 
Against Costly Repairs 


By Dale Shell 


J & M has supported our CoCo in the past and ts 
continuing with its new and improved disk controller, a 
nicely packaged disk drive and Memory Minder, a disk 
drive test program. All three products interlink and are very 
good. 

The new disk controller is well made, with J & M’s 
standard metal case and gold contacts on the circuit board. 
It is compatible with both the original CoCo and the new 
CoCo 2s. The new features include a parallel port which 
supports either a Centronics compatible printer or J & M’s 
new hard drive. Another new feature is an external ROM 
switch, which allows switching between two ROM (DOS) 
chips. The controller comes with the new version of JDOS 
and the associated manual. The new JDOS comes on a 
27128, 16K EPROM. This is a 28-pin chip. This socket also 
accepts a 2764, 28-pin EPROM. The other socket inside the 
controller accepts the standard 24-pin chip. This can be a 
Radio Shack Disk BASIC ROM, a 68766 or 68764 EPROM. 

Therefore, you can have two DOSs installed and can 
switch between the two. While the new JDOS ts much more 
compatible with existing software, this switch allows the use 
of a Radio Shack DOS in the second socket, thereby 
eliminating all compatibility problems. If you want to, you 
can replace the JDOS chip with a DOS burned into a 27128 
or 2764 EPROM. With both sockets available and the 
ability to use either 2764s or 27128s in one of the sockets, 
this really leaves open a host of options. The new JDOS 
includes all the older JDOS commands plus the ability to 
boot OS-9 from either a floppy disk or a hard drive. It can 
also boot Memory Minder, the disk drive analysis program, 
but more on that option later. 

The parallel port can be used for either a printer or hard 
drive. At this time, J & M has the five meg and 10 meg drives 
available, with the 20 meg promised by the time this review 
is published. The hard drives work with OS-9. The hard 
drive memory can be broken up into as many as seven 
partitions, but none can be larger than five meg. 

The printer option allows the use of the serial port for 
other purposes, but it does have a few drawbacks. First, it 
does not come with a printer cable. Secondly, if you have 
a printer that requires a pulse width of six ms or larger, you 
will have to use a pulse extender. This can be purchased from 
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J & M for $25. You need to check your printer manual and/ 
or call J&M to find out. Some of the printers that need the 
extender include the Epson RX-80, Riteman Plus, Oxidata 
Microline 83, and all Olivetti printers. 

You can get the new JDOS controller alone or with a drive 
system. The drive system includes the new JFD-CP disk 
controller, complete with the new version of JDOS 
Operating system, and a drive with case and power supply. 
The options include either a single- or double-sided drive. 
I really like the horizontal mounting that J & M uses, and 
the case seems to be very sturdy. 

With JDOS, using double-sided drives, the smallest 
program takes up the equivalent of two granules. There ts 
really very little that can be said about disk drives. J & M’s 
have well-built cases and they are reasonably quiet. 

The last part of this trio is the Memory Minder. With this 
you are presented with a menu for clamping test, spindle 
speed test, index hole timing test, alignment sensitivity test, 
head alignment test, directional seek test, head rotation test, 
a special quick test and options for an analog alignment aid 
or change test parameters. 

The test provides a quick summary indication of your 
disk drives for all the tests listed. Once this test is started, 
it runs to completion. On each of the seven tests you will 
get either a pass, marginal or fail indication for that test. 
If you get a marginal or fail, you should test that section 
more closely, or have it tested by a qualified technician. 

A word of warning, however: If you find an error and 
you are not technically familiar with the hardware, I suggest 
you get expert advice before adjusting anything, since you 
may make it worse. Some test conditions are affected by 
other factors and not just the one that is being tested. As 
in the clamping test, the quality of diskette clamping is 
normally a function of how well the diskette is rotating in 
a circle, but if the drive is out of alignment, the clamping 
test results may be meaningless. Make sure you read all the 
notes in the DDA manual. If you do get a fail on the 
clamping test and the diskette is not the problem, then the 
problem should be referred to the manufacturer. 

The spindle speed test measures the rotational speed of 
the disk drive. The speed should be between 294-306 RPMs. 
If you have a disk drive manual, this should be easy to 
adjust. Just remember, if you have not done this before, be 
careful. The next test, the index hole timing test, measures 
the time difference between the leading edge of the index 
hole and the beginning of the sector ID mark. Ideally, the 
time will be 200 microseconds, but can be in the range of 


100-300 ms. This ts a fairly large margin, but if the timing - 


is out, the DDA manual gives the procedure for adjustment. 

Another feature of the test allows you to determine the 
skew of the head. This is to determine if the head is 
perpendicular to the disk surface. To do this test, just 
compare the difference of hole timing from the inside and 
outside tracks. This is not something you can adjust, so let 
us hope it is OK. If the head skew is out, you will have to 
return the drive for refurbishment. 

The alignment sensitivity and head alignment tests are 
used during head alignment. The alignment sensitivity test 
relates to how tolerant the drives will be to a slight head 
misalignment. 

The directional seek test gives a measurement of how 
precisely the drives can repeatedly position the head over 
any track on the disk. The test measures the radial alignment 
when the head is moved in to a test track and then when 
it is moved out of the test track. The two measurements are 
compared; any discrepancies are probably due to hysteresis, 
and if excessive, the drive should be refurbished. 


The last test 1s the head rotation test. This test determines 
how close to the center line of the tracks the head moves. 
The optimum alignment will have the head center line 
parallel to the track tangent line. 

The analog alignment aid is not a test, but is very useful 
if you are testing drives in the traditional manner using an 
oscilloscope and an analog alignment disk. This section 
allows you to start and stop the drive motor, and position 
the drive head. There is very little that is automatic. This 
is useful to the more experienced. 

Overall, | think the DDA 1s a good product to have 
around. A technician can use it in his day-to-day work and 
the casual user can periodically check the different 
parameters of the drives to see if a technician is needed. 
Early detection of a problem can reduce or eliminate costly 
repairs. 

The price varies according to what controller you have, 
but $59 for single-sided and $75 for double-sided drives can 
be thought of as insurance against repairs in the future. 


(J & M Systems Ltd., 15100-A Central SE, Albuquerque, 
NM 87123, Drive 0 (SS) $279, controller $139, Memory 
Minder (SS) $59, (SS or DS) $75) 
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Casper CoCo Quick 
Assembler: Ideal 


for Beginners 





Casper CoCo Quick Assembler is a fast combination of 
monitor, editor, assembler and debugger. To get this extra 
speed, the editor looks up the symbols and opcodes and 
saves indexes into tables instead of characters. The program 
comes with both a 32K version and a 64K version. The 64K 
version places the machine language portion of the program 
and your source code file in high RAM leaving most of low 
RAM for your machine language program. | like this 
program but there is good news and bad news. 

First the good news. This is a delightful program. It is 
easy to learn and easy to use, ideal for a beginner. The BASIC 
loader boots the system and sets certain parameters. From 
this portion of the program you can save and load source 
code files and machine language files. The program can 
create its own backup copy onto a blank disk. From this 
part of the program simply press ‘M’ to go to the monitor. 

The monitor-debugger is also the command level. It is 
here you perform most operations. You can examine and 
change memory, assemble source code, print out source 
code or object code, set up to eight breakpoints, search up 
or down through source code for a target string, execute 
machine code and view the registers as you go. You can 
scroll up or down through the source file line by line. 
Numbers can be displayed in hexadecimal or decimal. 

The screen used by the program is different from the text 
screen. You can view the usual text screen at any time. Block 
move, block copy, block delete and block print can be 
performed on the source file. You can ask for the number 
of the line you are in, and you can jump to any line in the 
source file by entering the appropriate line number. When 
executing machine code, you can walk through the program 
one line at a time, a number of lines at a time, or execute 
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until you reach a breakpoint or a certain number of 
breakpoints. 

The editor is where you type in the source code. You can 
edit, insert and delete lines of code or simply scroll up or 
down one line at a time. If you enter an improper opcode 
or an obvious syntax error, the program alerts you with a 
beep. 

The assembler is activated from the monitor. If an error 
is encountered, the monitor jumps to the problem line for 
debugging. 

Now for the bad news. I had a lot of trouble booting this 
program. On my old (gray) ‘D’ board 64K CoCo I get an 
error message. Typing RUN over again solves the problem 
for this old CoCo. On the newer (white) 64K CoCo 2 the 
computer hangs up completely. 1 managed to get the 32K 
version to run on the 64K CoCo 2 by resetting the computer 
and then typing RUN again. I suspect that this is a minor 
problem with the BASIC loader and may be corrected in 
future versions. 

Another problem in the BASIC loader is the printer Baud 
rate. The manual suggests that you can set the Baud rate 
in Line 50 of the loader. After having some trouble with the 
printer, I discovered that the Baud rate had already been 
set at 9600, (easy enough to fix once found). 

The manual is not clear enough in explaining how to save 
machine code once it has been assembled. Also unexplained 
is the Load command. This command lets you load machine 
language into memory. However, there seems to be no way 
to access it. The program deals only with source code and 
machine code that has just been assembled from source 
code, not machine language files. There is no disassembler 
in this program. This means that you cannot examine 
machine language portions of memory (such as the basic 
ROM) in terms of assembly language. Advanced users may 
find this a drawback. 

Except for the bugs I have mentioned, however, this is 
a good program and has a reasonable price. 


(Earl W. Casper, 6012 S. 14 Place, Phoenix, AZ 85040, $20) 


— James Ventling 











Software Review 
Eagle Lander 


is True to Life 





What is an Adventurer to do? After managing thousands 
of nuclear power plants, averting numerous air disasters and 
conquering many kingdoms, what is there left to do? 
Conquer the moon? That’s exactly the task you are given 
as the owner of Saguaro Software’s lunar lander Simulation 
entitled Eagle. 

The idea of a computer-simulated lunar landing is 
certainly not a new one. These simulations first appeared 
on computer networks that predate the CoCo by many 
years. [he makers of Eagle, however, have taken the lunar 
lander idea quite a bit forward. Eagle is controlled with 
joysticks on the high resolution (PMODE 4) screen. The 
bottom portion of the screen plots the position of the craft, 
providing a graphics representation of the craft in flight. 
Meanwhile, the top portion of the screen provides the pilot 
with a host of instrumentation which reports such impor- 
tant data as relative position, altitude, horizontal and 
vertical airspeed, acceleration, percentage of rocket thrust, 
fuel remaining and time elapsed. All these indicators help 
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the would-be pilot appreciate the difficulties involved in 
managing such a complex operation as a moonshot. 

The complexity increases as the craft approaches one of 
the two possible landing sites. Both horizontal and vertical 
airspeed must be brought down to near zero precisely when 
the craft is located in the proper position. This is an 
extremely difficult task, which requires many trials to 
achieve reasonable adeptness. To make life more dangerous, 
the user can “play damage control” by choosing the 
advanced difficulty level. It introduces such emergencies as 
fuel leaks, maneuvering problems and computer screen 
failures. These malfunctions provide extra challenges and 
require greater mastery of the craft’s abilities to perform a 
successful landing. 

Other operational commands allow the user to adjust the 
attitude window for fine or coarse control of direction (a 
very important feature when trying to land), perform a fuel 
dump and predict future position based on present course 
and speed values. Using the latter command, the user may 
jump ahead in time and accept the predicted values and 
position just as if he had maintained the course for the 
prescribed time. All these functions add greatly to the 
playability of the Simulation (not to mention saving the 
keyboard from frustrated thrashings). 

Despite Eag/e’s complex nature, the user manual provides 
excellent insight and interpretation of the physics involved 
in an actual lunar landing and how the user can apply these 
to his advantage. The manual also accurately describes the 
command structure and flow of the game. The documen- 
tation is complete in every respect, including a guarantee 
to replace defective disks unloadable by the original owner. 

The author of Eagle, Art Martin, has done an excellent 
job in producing a realistic Simulation of a lunar landing. 
The Simulation is so true to life, in fact, a certain sense of 
“harsh reality” is incorporated into the program. This is not 
an easy-to-master Simulation, rather, it’s a reflection of a 
technologically advanced procedure and requires consider- 
able practice to perform a successful landing. Therefore, this 
program is excellent for hardened game players who are 
looking for a considerable software challenge which won’t 
sit on the shelf after the first few successful landings. 


(Saguaro Software, P.O. Box 1864, Telluride, CO 81435, 
$24.95 tape, $29.95 disk, requires 32K and two joysticks) 


— Eric Oberle 
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Interactive Wishbringer — 


A Stimulating Challenge 


On ascale of one to 10, I’d give Wishbringer 9.95+ points. 
Wishbringer is an interactive fantasy — you interact with 
the program to create a story with many possible solutions. 
Unlike many Adventure games, which accept only two- 
word phrases (typically a verb and object), Wishbringer 
encourages you to talk to it in complete — even compound 
— sentences. Every aspect of this package has been carefully 
designed and implemented. 

To enjoy this fantasy, you need a CoCo 2 with 64K of 
memory and a disk drive. Optional items include a second 
disk drive and a printer. 

The object of this fantasy is to free the seaside village of 
Festeron of trolls, vultures and fortress-like towers. At the 
fantasy’s beginning, you are a postal clerk, with the task of 
delivering a strange-looking letter to the local Magick 
Shoppe. When-you succeed in reaching the shop, you learn 
that the proprietor’s cat has been kidnapped by the Evil 
One. She asks you to rescue her cat, and in return she will 
give you a Stone with magical powers — Wishbringer. Upon 
leaving the Magick Shoppe, you discover that the once quiet 
and peaceful village has become a battleground between the 
forces of good and evil. Only you, with the magical 
assistance of Wishbringer, can rid the town of its evil 
inhabitants. 


The documentation supplied with this program is superb. 
The 25-page, color instruction manual contains the legend 
of Wishbringer and complete operating instructions. 
Suggestions are presented for the novice, and even a sample 
script is included to illustrate how the fantasy develops. 
Instructions are given to save a position in the fantasy and 
to restore to that point. Additional instructions allow you 
to send the actual script you create to the printer. Appen- 
dices describe system commands, list some recognized 
verbs, explain error messages (called Wishbringer Com- 
plaints), and present copyright and warranty information. 
Appendix G gives a brief biography of the fantasy’s 
originator, Brian Moriarty. 

But the documentation doesn’t stop with the superb 
manual. Also included is a poster-sized postal map (also in 


color) of Festeron, showing the roads and identifying many: 


of the buildings (but not the Magick Shoppe). A reference 
card summarizes much of the information presented in the 
manual. It also details a diagnostic procedure which will 
check if the story data are correct (complete and undam- 
aged). (This allows you to determine whether a problem is 
hardware- or software-related.) 

Still another piece of documentation 1s the sealed letter 
you are to deliver to the Magick Shoppe. You open this only 
when instructed by the fantasy to do so. 

The packaging is excellent. In addition to the documen- 
tation, Infocom has included a warranty registration card 
(submitting this card gets you acomplimentary subscription 
to the New Zork Times newsletter) and several pieces of 
advertising literature. One of these announces the availa- 
bility of hints and maps for purchase. 

Although I am past the age that is so fascinated with 
games, I really enjoyed doing this review. I was constantly 
challenged and frequently surprised as the fantasy evolved. 
The documentation left nothing to my imagination (except, 
of course, the fantasy itself). Response was quick, and often 
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revealed the author’s sense of humor. 


(Infocom, available in Radio Shack stores nationwide, disk 
$34.95) 


— Jerry Oefelein 
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Check out Computer and 


Business Bankbook 
By Neil Parks 


Sunrise Software has two new programs available that 
not only serve as check registers, but also print checks. If 
you pay the same creditors every month, this could prove 
to be a real work saver. 

Computer Bankbook is designed for home users. Busi- 
ness Bankbook — available in two versions — is a similar 
program designed for business users. Both programs are 100 
percent BASIC and come on disks that can be backed up. 
Both come with a “code plug.” This bit of hardware plugs 
into the right joystick port, and without it the program 1s 


unable to run. . 
Since Computer Bankbook is a BASIC program with no 


machine code, it should be compatible with all operating 
systems, but it isn’t. The disk I tested appeared to run 
properly under JDOS, but certain data fields, which I 
wanted to leave empty (as permitted by the program), were 
filled with random garbage. Attempts to edit the data via 
the program’s edit routine resulted in various crashes and/ 
or loss of entries. 

I had no problems with DECB 1.0 or the disk version 
of ADOS, so I presume that the problem with JDOS is 
caused by differences in direct-access disk formatting, but 
I don’t know. Copying the program to a JDOS-formatted 
disk did not help. 

The program ends by cold-starting the computer (POKE 
113,@:EXEC 40999). With the disk version of ADOS, there 
is garbage on the screen, but pressing the Reset button 
restores the built-in DOS. Computer Bankbook is a natural 
for ADOS’s RSV high-resolution text screen — or would 
be, but for some superfluous semicolons which should be 
removed from the menu-printing routines. The Edit screens 
actually work much better with RSV than they do with the 
regular 32-by-16 display. 

The eight-page manual is well-written and easy to 
understand, though a couple of points were left out that 
probably should have been mentioned. 

The first step in setting up the check register is to enter 
a beginning balance. Although there are only seven items 
on the main menu, the beginning balance is selected by 
pressing ‘8’. That was probably done because, after entering 
the balance, you won’t use that routine again for a year. 

There are two ways to enter checks. If you are going to 
have the computer print your checks, you use the Check 
Printer routine. When each check 1s printed, it is automat- 
ically entered into the register. For creditors you pay on a 
regular basis, enter their names and addresses into a file. 
Then every time you want to send a check to one of those 
creditors, you call up that file. Enter the last check number 
used, and the check or checks printed are properly 
numbered. 

There is also the option of special checks, for which the 
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name and address of the payee is not stored in the file. 

The second method of entering checks in the register is 
also the method for entering deposits — the Add Checks/ 
Deposits Manually selection. The manual suggests that you 
may wish to use the Check Printer routine in preference over 
the Add Manually option even if you don’t plan to have 
the computer print your checks. Personally, I disagree. I 
found the Add Manually option much easier to use. 

(The manual says that if you wish to use the Check Printer 
routine without actually printing checks, you must change 
one line from a GOSUB to aREM. What they forgot to mention 
is that this change affects only the regular checks, not the 
special ones.) 

Although the manual doesn’t make it clear, all checks and 
deposits must be entered with a two-digit month. For 
example, January 25 has to be 01/25, not 1/25. If you enter 
the month with only one digit, the entry is accepted, and 
the check is printed properly. But the routine that prints out 
the transactions for a particular month keys on those two 
digits, so any entry with a one-digit month is omitted from 
the listing. 

The day can go either way — 12/4 and 12/04 are equally 
acceptable. The year is optional. Although the Computer 
Bankbook manual doesn’t expressly say so, it becomes 
obvious that one year is the maximum length for the file, 
because the printout for one month doesn’t key on the year. 

All entries for a given month must be consecutive. 
Otherwise, the balance column in the printout for that 
month will look strange. This may cause a slight problem 
if you write a lot of checks early in the month, before you 
get your statement and find out how much interest you 
earned for the preceding month. But you can always date 
the interest deposit as of the first of the new month to get 
around that. Again, this is a point that should have been 
mentioned in the manual but wasn’t. 

Each check is considered to be outstanding until you 
indicate, either on entry or editing, that it should be canceled 
(cleared). When you get your monthly statement from the 
bank, just print out a list of outstanding checks. A total will 
be printed with it. Add that total to the present balance and, 
if it agrees with the bank’s balance, you’ve made balancing 
your checkbook quick and easy. (Deposits are considered 
canceled on entry, but you can always edit one to outstand- 
ing if it occurred too recently to be on the bank statement.) 

Each check and deposit may be assigned an account 
number. Here’s where the program really proves its value. 
You can print out a list of transactions for each account 
number, for any one month or for the entire file, and the 
list will be automatically totaled. For example, let’s say all 
your checks for charitable organizations are assigned to 
account 18. Tax time comes and you want a total of 
charitable contributions — it’s as easy as printing out 
account 18 for the year. For this feature alone, Computer 
Bankbook is well worth twenty bucks. 

There are a few quibbles, albeit minor ones. Author 
James Goldsberry did not make allowances for writing a 
check larger than $999.99. The program can handle it, but 
the printout looks strange because it exceeds the “print 
using” format. (Four-figure deposits and balances look 
OK.) 

There is a slight inconsistency in those routines that 
require a Y/N response. In some of them, the ENTER key 
is interpreted as Yes, in others as No, and in yet others as 
no response. Obviously the third situation is the most 
desirable and should have applied in all cases. 

When you enter the beginning balance (via menu option 
8), I suggest you enter the amount as zero. Then, as your 
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first transaction, post a deposit in the amount of the 
balance. Use the edit function to change the name from 
“deposit” to “beginning balance” or “balance forward” or 
whatever. That way, if you ever need to recall the file for 
a prior year, you don’t have to make any adjustment to the 
beginning balance. This method lets you use the same disk 
for more than one checking account at the same time — 
your personal account, your spouse’s account, a joint 
account, etc. When you finish working with each account, 
just copy the CHECKS.INF file to a library disk under the 
name of your choice, and recall the one wanted by killing 
CHECKS.INF on the system disk and copying the appro- 
priate file in its place. You can have several years for several 
accounts stored on one library disk. That makes more sense 
to me than creating a new system disk for each account file, 
as the standard procedure would require. 

Business Bankbook is essentially the same program, with 
a few added features. The main difference is that instead 
of assigning each transaction to one account, you can assign 
up to four accounts. So if an invoice includes merchandise 
cost, freight and tax, for example, each of these components 
can be posted to its own account. Enter the amount for each 
account, and the total is calculated automatically. 

Business Bankbook comes in two different versions. 
System I (also known as Bank 7.1 or 7.3) uses one disk drive. 
System II (alias Bank 9.1 or 9.3) assumes two drives — one 
for the system disk and one for data storage. The beginning 
balance entry appears on the menu in Business Bankbook, 
but works the same as in Computer Bankbook. (With 
System II, my alternative method of the zero beginning 
balance becomes even more useful: You don’t even have to 
kill and copy files to go from one to another. Just rename 
the appropriate file on the data disk to or from CHECKS 
. INF.) 

The 10-page manual for Business Bankbook was appar- 
ently written some time after the other one, because it does 
mention that each file should contain one fiscal year, and 
it does not suggest using the check printer routine to enter 
checks without printing them. 

I did not test Business Bankbook under the non-Tandy 
operating systems, but since the two programs use similar 
direct-access disk I/O routines, I would expect the results 
of such a test to be the same as they were for Computer 
Bankbook. 

Business Bankbook allows you to enter a table of Active 
Accounts, consisting of any account numbers you regularly 
use, and a name for each account. This chart can be printed 
out at any time, and will appear in numerical order even 
if you didn’t enter them in order. Also, the account names 
in the table appear on the check vouchers. 

Unfortunately, there are two bugs in this routine. In the 
Edit mode, you are asked if you want to change the account 
number or account name. But any change in the account 
name erroneously produces a random change in the 
number, and any attempt to change the number fails. Also, 
if you use an account number that is not in the table, the 
check printing routine puts an inappropriate name in 
instead of a blank space. There is one line on the System 
I program that says RUN BANK.10. However, BANK.10 is 
a file which occurs only in System II. Somebody didn’t 
debug as thoroughly as he should have. 

On the plus side, by the time Business Bankbook was 
written, Mr. Goldsberry corrected the inconsistency in his 
Y/N routines, so that only a ‘Y’ or an ‘N’ would be accepted 
as a response. 

Business Bank book also has a routine called Convert that 
allows you to convert your Computer Bankbook files to the 





Business Bankbook format if you want to upgrade. The 
Business Bankbook manual says that a Computer Bank- 
book file of about 300 records takes seven granules of disk 
space. After conversion to the Business Bankbook format, 
the same data occupies eleven grans. 

The manuals for both Computer Bankbook and Business 
Bankbook state that the check printing routines are 
expressly designed for use with Nebs Computer Forms 
tractor feed checks #9025-1, and that Line Printer VII, 
DMP-100, and possibly other inexpensive printers can’t 
handle such heavy paper. 

With each program comes a checklist to fill out and send 
in if you have occasion to write to Sunrise Software. “Please 
outline the problem you encountered in as much detail as 
possible,” says Sunrise. “We will do all we can to help you 
solve it.” I like that. 


(Sunrise Software, 8906 NW 26 St., Sunrise, FL 33322, 
Computer Bankbook, 32K, one disk, $19.95; Business 
Bankbook, specify System I for one drive or System II for 
two drives, $49.95; $2 S/H) 
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Take a Chance — Play Skance 


Do you like games of chance such as Yahtzee or dice? Do 
you like to go one-on-one with your computer and 
sometimes win? If so, you’re a likely candidate for Skance. 

The program is written entirely in BASIC and requires a 
16K CoCo with Extended Color BASIC. 

When I ran the program, the instructions were simple and 
straightforward. Besides the instruction screen, there are 
four other screens you will use: The Player Screen lists all 
of the players, the Score Screen shows the current scores, 
the Dice Screen shows the dice being rolled and the Winner 
Screen gives the winner’s name and score. 

After the instructions, you are asked how many people 
will be playing. Up to four people can play or you can play 
against the computer. 

The object of the game is to score as many points as 
possible. To score, you need to stop rolling the dice before 
your point number comes up a second time. Your point 
number is the first number you rolled. 

The game consists of seven rounds of play. After the 
seventh round, the winner’s screen comes up and displays 
the winner’s name and score. Although the computer keeps 
track of all players’ scores and who is playing, once a player 
begins rolling the dice, there is nothing displayed on the 
screen to tell the players who is rolling. We found this to 
be a problem. 

After you decide how many people are going to play, the 
screen indicates whose turn it is. There are two options: 
press the ‘A’ to roll the dice or press the ‘S’ to see the current 
scores. If the ‘A’ is pressed, a screen comes up showing two 
dice. After each roll, you are given three choices: roll again, 
see score, or next player. These are chosen with the ‘A’, ‘S’ 
and ‘N’ keys. If any other key is pressed, your turn ends 
and the next player is up. 

This game requires no skill to play, but if you like games 
of chance, this may be for you. 


(Bob’s Software, P.O. Box 391, Cleveland, OH 44107, send 
formatted disk and return postage.) 


— John H. Appel 
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No Frills U-Buff 


is an Excellent Value 


As much as we hate to admit it, the present-day world 
puts much emphasis on time. Hurry this and hurry that; it 
is as if we were in arace to the finish! Well, the U-Buff printer 
buffer from Digital Devices fits in nicely. 


I have given this little gem a thorough run for its money. 
Over the last month and a half, I have sent it files from 
Delphi, files from my word processor, data from my BASIC 
programs and graphics. It hasn’t let me down yet. It has 
always printed each character reliably. 

For those who don’t know, a printer buffer is nothing 
more than a go-between. It goes between your computer and 
printer. A printer is limited in speed. The print head can 
only move so fast across the page. However, a computer 
can send data much faster. So the buffer allows the 
computer to finish sending its data more quickly. Therefore, 
you don’t have to wait all day for the printer to finish before 
going ahead with your work. 


As an example, when I told my system to print a 40.5K 
file, the prompt was back on the screen in 83.5 seconds. I 
was already involved in my favorite game when my printer 
finished printing out the 30 double-spaced pages 15 minutes 
and 53 seconds later. 

The U-Buff is available in two configurations: 16K 
memory and 64K memory. A nice added feature is the 
average user can upgrade the unit from 16K to 64K by 
himself. The manual gives information on what chips to buy 
and how to install them properly. The only drawback is that 
the one-year warranty only applies to the configuration 
purchased from Digital Devices. Still, I believe this is very 
reasonable. 

The buffer is designed to accept input from any computer 
having a Centronics interface. Since my serial/ parallel 
converter terminates in a Centronics plug, I had no 
problems. The unit also terminates in a Centronics plug for 
the printer’s parallel port. 

The U-Buff comes with a 14-page, easy to read pamphlet. 
The instructions cover installation, testing, troubleshoot- 
ing, upgrades and a whole slew of technical information plus 
a glossary. 


Despite its usefulness, keep in mind a printer buffer isn’t 
for everybody. But anyone with a business or who does a 
lot of printing will surely welcome anything to help them 
out. 

The U-Buff is an excellent, ‘no-frills printer buffer. For 
the reasonable price it is a good work horse with a good 
deal of backing from the manufacturer. This one gets four 
stars. 


(Digital Devices Corporation, 430 Tenth St., Suite N205, 
Atlanta, GA 30318, 16K $119.95, 64K $149.95) 


— Cray Augsburg 
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Wico Command Control 
Trackball Takes 


the Punishment 


There must be an easier way to get a better score without 
causing serious harm to your trusty CoCo. We all tend to 


get carried away during the heat of battle, and this - 


excitement is often transferred into “white knuckle” 
treatment of some relatively fragile plastic parts. 

It’s only human nature to get excited during competition. 
Have you ever noticed that many commercial arcade games 
use a trackball control instead of a joystick? The action at 
these arcades often got so intense, the manufacturers had 
to find a more reliable alternative. Well, that alternative is 
available for the CoCo in the form of the Wico Command 
Control Trackball. 

This device replaces your joystick and 1s very rugged. It 
measures 5 by 6 by 1% inches and weighs a little over one 
pound. It uses, of all things, a billiard ball as the primary 
user interface. A firebutton is located at the upper left corner 
On top so it’s easy to get to with your left thumb. If you 
want to put it on your computer table, it won't slide around 
easily because it has flat rubber feet on the bottom. It does 
require a separate power source, which is included in the 
form of a plug-in wall transformer. The other cable 


terminates in a standard five-pin DIN plug to fit the CoCo 
joystick connector. 

Operation is simple. You get full 360 degree movement 
by just moving the ball with fingers or palm. It’s easy to 
use and allows controlled movement by simply moving the 
ball fast or slow. It’s a unique feeling and one you have to 
experience to fully appreciate. | tried it on several games 
and was able to get higher scores than I could with my 
joystick. I also used it with CoCo Max and liked the smooth 
feel and easy positioning of the cursor. The only drawback 
I noticed on CoCo Max was it took longer to go from the 
workspace to the menu due to the vernier action of the 
device. 

The device boasts the use of a microprocessor control 
circuit using photosensors and a built-in analog-to-digital 
convertor with an eight-bit output. Since the CoCo only has 
a six-bit joystick port, that probably explains some slight 
positioning errors with programs like CoCo Max. Wico 1s 
aware of this problem and even discusses it in the instruction 
booklet. 

This device is best suited for CoCo games, although it 
will most certainly provide excellent service in other 
programs normally requiring a joystick. 

Wico guarantees the Command Control for one year 
which attests to its durability. This device can take all the 
punishment you can give it — so bring on the Klingons! 


(Spectrum Projects, Inc., P.O. Box 21272, Woodhaven, NY 
11421, $19.95 plus $3 S/H) 


— Jerry Semones 





CONTEST WINNERS continued from Page 8 


receiving the Education Progamming Award. 

Bob has produced a most consistent line of 
Educationally sound programs for use on CoCos this 
year. 

In fact most of his programs have broken new 
ground in the use of the CoCo in schools. 

Tandy gave Bob a 16K ECB computer, for which 
Computer Hut Software provided a 64K upgrade, plus a 
number of Education programs for use at St Edmund's 
Catholic School Ipswich, Bob’s place of employ. 

The OS 9 Programming Award went to Ian Lobely of 
Tandy in Wagga. 

His program will be published in Australian 
Rainbow next month. It demonstrates the very 
successful use which OS 9 can be put to in business, 
and opens the way for some very exciting stuff on 
the CoCo3 with the Level 2 OS 9. 

Ian receives a 68000 Class Computer (CoCo add on) 
from Blaxland Computer Services for his trouble. 

George McLintock is the recipient of a Goldsoft 
CoCoConnection for his two Utilities competition 
entries, "Compress” & "Remove”. 

These programs are just two of a vast number we 
received this year for this competition. In _ fact, 
due to its popularity, this competition will be 
expanded in the coming year. 

Finally to the games. 

The games we received this year were the best we 
have ever seen. Not only that, but there were a lot 
of games at this same excellent level. 

In the Adventure Section, Andrew White was’ the 
winner with his "Goldsoft Adventure”, which, by the 
way, almost became a reality for someone! 

His game shows mastery of the disk system & of 
graphics handling techniques and what’s more, is fun 
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to play! 

Andrew receives a Video Amp from Geoff Fiala, and 
a Koala Pad from Tandy for this fine-game. 

Andrew McLintock wrote a Simulation called U Boat 
& this fought off some very stiff competition to win 
Andrew the CC Bus from Paris Radio for the best 
Simulation submitted this year. 

Finally, Craig Stewart submitted two excellent 
Arcade games for CoCo, "Tank” & "Shoot Out”. Both 
these games show a working knowledge of the graphics 
screen in Machine Language. 

In particular, "Shoot Out” is a fun game to play 
with the added advantage that it is played against a 
human adversary. 

Craig has won a Tandy Disk Drive 
congratulate him on an excellent job. 


and we 


New Competitions. 


The competitions for the new year now get under 


way. The first competition for the year, with a 
closing date of 7th February is the Music 
Competition. 


This competition, if sufficient entries ensue, 
will be broken into a number of categories dependant 
on the basis of the program, ie whether the program 
uses the PLAY command, the SOUND command, Machine 


language, or one of the many add on units available 
today. 

The competition is open to owners of all 
computers, so we are looking forward to seeing what 


the owners of the IBM PC’s especially, can turn out! 


Will they make better music than CoCo owners? Can 
our Commodore readers do any better? 

Well we’ 1] see as the competition 
unfolds. 
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Samples of 320 by 
192 mode from 
demo program for 
new CoCo 3. Six- 
teen colors availa- 
ble. Highest resolu- 
tron available: 640 
by 192: 





By 
Greg L. 
Zumwalt 


recently sreéccived my sixth. © olor 

Computer. As an applications pro- 

grammer, I tend to wear them out 
long before their time. | use Color 
Computers in developing software and 
hardware for the CoCo as well as other 
equipment, and give the poor machines 
quite a beating in the process. 

| removed Color Computer five from 
active duty and plugged number six into 
the expansion interface. After installing 
the OS-9 boot disk in Drive 0, | typed 
DOS, and a message appeared on the 
screen: 
Welcome to 05-9 Level II for the 
Color Computer 3 


Level 1H? Color Computer 3? 


Hardware Preview 

The Tandy Color Computer 3 is a 
true next generation CoCo. The heart 
of the machine is a two-megahertz 6809 
teamed with the Tandy designed GIME 
(Graphics Interrupt Memory Enhance: 
ment) chip. The GIME contains the 
Color Computer 3 enhancements, as 
well as the standard Color Computer 
VDG logic. Tandy retained the older 
Color Compuicr logic to remain com- 
patible with most of the existing CoCo 
software. The enhancements. however. 
are IMpressive. | | 

How about SI2K RAM capacity with 
an MMU (Memory Management Unit) 
to assist in managing a? Or 320 by 192 
lo-color graphics? Or 640 by 192 tour- 
color graphics? What about composite, 
RGB or standard RE vyideo-output? | 
like an 8O-column display. The Color 
Computer 3 contains all of these tea- 
tures, plus more. 


Software 

tandy provides various software 
enhancements that utilize the Color 
Computer 3 hardware. BASIC is compat- 
ible with previous 64K Extended BASIC, 
but allows setting screen widths (32, 40 
or 50 Coles). Scrcen. colors: (lore- 
ground, background aad the border). 
graphics modes (now up to 640 by 192. 
four colors). and more. 

However, the real power of the new 
Color Computer becomes apparent 
with Microware’s OS-9 Level EL Oper- 


lamiliar with OS-9, Pwould suggest that 
now there isa real reason to des clop an 
interest i it. Bor those of vou familiar 
with Pevel LOS-9. vou will really enjoy 
Level He bevel His designed to exploit 
the expanded RAM capacities of the 
Golot Computer 3. Ake bevel tl on 
other systems. But-there is a ditterence. 
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Level T1 OS-9 for CoCo 3 supports 
windowing. a feature that, after having 
used it. }don't ever want to give up. 


Windows 

A window Is an area appearing on the 
screen that acts just liked regular 
display, the main difference being you 


can assign more than one window to the 


same screen. For example, as an appli- 
cations programmer, | am constantly 
switching between a text editor, an 
assembler, the application and a de- 
bugger. Anvone who has written assem- 
bly language programs knows that this 
evele often repeats, sometimes many 
times. resulting in lots of typing and 
typing errors. 

With windowing, I simply place a text 
editor window in the upper left-hand 
carmer of the screen. an assembler 
window in the upper nght-hand corner 
of the screen, a debug window in the 
lower left-hand corner of the screen, 
and finally, an application window in 
the lower right-hand corner of the 
screen. Each of these windows now acts 
as though | have four separate Color 
Computers. While the application 1s 
running. | can edit, assemble and debug 
all at the same time. Output from any 
of the programs appears instantly on 
the associated window. To direct Input 
to a particular program, all | have to do 
is press the CLEAR key on the keyboard 
until the cursor appears on that win- 
dow, then type. OS-9 allows me to 
define the size and location of each 
window. | can even define a window as 
the entire screen, in which case OS-9 
switches screens when | want to work 
on another, 

How does this work? OS-9 is what 1S 
Known as a multi-tasking multi-user 
operating system, This means OS-9 is 
designed to allow more than one pro- 
vram (called u task) and more than one 
user at a time to share the same com- 
puting resources. Level TH} OS-9 for the 
CoCo 3 takes this concept one step 
further by providing more than one 
screen (the window) to accomplish this. 


lets go through the process of creating - 


a Window using the OS-¥ Build utility. 


Building Your First Window 

The Build utility allows us to create 
an OS-9 procedure file. A procedure file 
is simply a disk file containing a series 
of OS-9 commands that OS-9 executes 
in order. To create the procedure file, at 
the OS-9 prompt, type the following: 

build window ate 


The Build utility responds with a 
question mark followed by a space. 
Now type the following: 

Loz ewd. 

merge syus’stdfonts -“wl 

display lb 20 @7 @@ O8@ 28 Vb BO 


QO? OP =7wl 
shell i=7wls 


Press ENTER twice after this last line. 
After the last FNTER, the Build utility 
returns to OS-9. There is now a proce- 
dure file on the disk called Window]. To 
run the procedure, at the OS-3: prompt 
type: . 
wWindowl 


OS-9 responds with the “&* symbol 


followed by anumber. This verifies that 


a aveum WauareConwa Wn el moreexelU) near: Cexereyben oveniicere 
its task. To see what happened, press the 
CLEAR key on the keyboard. A new 
screen appears with.a window in the 
upper left-hand corner containing the 
OS-9 prompt. This window, with its 
shell, allaws you to execute OS-9 com- 
mands just like the original screen. In 
effect, you have two computers. Press 
the CLEAR key again, and the original 
screen reappears. 
procedure file we created and see how 
it works. i Page 


Under OS-9 Level Hl. a window is | 


treated as simply another OS-9 device. 
The device name for a window contains 
the window descriptor (the ‘w’) and the 
window number (in this case 1). There- 
fore, to talk to window one the descrip- 
tor wl is used. re ay 

The first command, Iniz, initializes 
wl. This is similar to an Iniz of any 
other OS-9 device. i 

The second command, Merge, tells 
OS-9 which character set is to be used 
with wl (a variety of character fonts are 
now possible with the Color Computer 
3). | 

The third command, Display, sends 
the command sequence to OS-9 that 
creates the window. The command 


sequence contains [0 bytes describing to. 


OS-9 the command, type, location, size 
and color of the window to create. The 
first two bytes following Display are the 
create a window command. The third 


byte defines the window type: in ous 


example, a 640 by 192 four-color gra: 
phics window. Phe fourth and fitth 
bytes decribe the *X? and “Y° character 
location of the upper left-hand corner 
of the window. The sixth and seventh 
bytes -deline the OC? and Yo character 
size of the window. Finally. the cighth, 
ninth and [0th bytes describe the tore- 
ground. background and border colors 
for the window. 

The tourth command, Shelly creates 
a shell for wl. Phe shell is what-allows 
you to: execute anv ofthe OS-9 Com: 
mands or applications. 


Building Your Second Window: 
A BASIC Approach 

To further iWusttatc let's create a 
second window. However, this time let's 
create it using BASICO9 (which, by the 


Let’s examine the 


way, is included with the OS-9 Level 
operating system), and place it.on the 


“same screen that wl occupies, but in the 


upper right-hand corner. Press the 
CLEAR key to display wl. then at the 
OS-9: prompt, type: 

Basic@9 

The BASICO9 prempt appears. fol- 
lowed by B:. From here, type i the: 
following: | 
e window2 

enell “iniz we. 

dim command,path:byte 

dim count rinteger fe | 

data 27), 32,0.40 20.42 4 22 

open Hpath, ““w2° iwrite ; 

for count=1 to 12 

read command 

put ‘H#path, command 
nee Count 4. 

“Shel iccSshell baw. 

end 
q. 
Ole 

A second window appeats just to the 
night of the first. whose foreground 
background colors are opposite those of 
wl. Now press the CLEAR key. Notice 
the cursor on Wl disappears. while. a 
cursor appears on W2. Fach time the 
CLEAR key ts pressed. the next window 


is selected for kevboard input in round 


robin fashion. 
The BASIC approach appears some- 
what different from the procedure file 


“approach, however. they both accom- 


plish the task in a similar manner Phe. 
first line of the BASIC approach calls the 
BASICO9 editor, allowing you to type in 
the program. The second line telly - 
BASIC09 to send the Iniz w2 command 
to OS-9 the sumeoas. Enz wl of the 
procedure tile approach. Fhe third and 
fourth lines define the variable types to 
be used in the program (a requirement 
of BASICOX). The fifth line is a DATA 
statement containing the command 
sequence that creates the window, The 
sixth line opens a path allowing BASIC. 
to communicate with window two. The 
seventh, eighth, ninth and 10th lines are 
aPOR/NEXT loop. reading data from the 
DATA statement and sending it through 
the path to window two. The Flth line 
creates a shell on window two. The 12th 
line ends the program. The [3th and 
I4th lines exit the BASICo9 editor and ~ 
run the program, : 


Putting Windows to Work 

It is important to realize that even 
though a window is not selected tor 
kevboard input, the program on it fs sull 
running. fo illustrate, let’s put the two 
windows we have created to work. We 
will make window one (Wl) a clock that. 
displays date and time continuously. 
lhen, on window two (w2) we'll illus- 
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trate another windowing concept. 
Press the CLEAR key Cn the keyboard 

until the cursor appears on wl. Then 

from the BASIC0O9 B: prompt, type: 


Kidd} window? 

e clack 

Pivot 3 Me soto lng 

Orn orcs ls?) 

18 1f dateS=time then goto 10 
Pise 

time-dated 

Gripk charhy 1 

or int 
endi f 
goto 1@ 


time. 


ie 


ee a 


A BASICOY program called Clock is 
now running on wl, displaying the tine. 
Now press the CLEAR key. Notice that 
the cursor moved to w2, but the clock 
program on wl is still running. This ts 
adm cxample of how multi-tasking 
multi-user and. of course, windowing 
really shine) W2 is now available to 
Write another program, run a game, or 
Whatever, while wl continues to run the 
clock! Another plus from the 0S-9: 
prompt on w2. type. 


Oe reels Bo, 


Now vou have both wl and w2 avatl- 
able for BASIC programs, but the real 
piusas both wi and w2 share the same 
copy of BASICO9. No need for a second 
copy. The design of OS-9 allows. pro- 
grams to be re-entrant, essentially 
meaning that the same program can be 
used by more than one person at the 
same time, providing. big savings in 
MemMOry, 3 


The Overlay Window 

The windowing system provides a 
second type of window, the overlays 
window, which docs what the name 
suggests. An overlay window overlays 
an existing device window (windows wl 
and w2.that-we previously created are 
device windows). Overlay windows are 
usctul when an application needs to 
prompt the user for input, display menu 
selections. announce messages and so 
forth. because they can be designed to 
really attract the user’s attention, 

Creating an overlay window is rela- 
tively simple. So while our clock ts 
running on wl. we will use BASICO9 on 
w2 to create our first overlay window. 

From the BASICUY Bz prompt on we, 
a oes : 


ea guerlay 
dim Gounrtrinteger 
Gdimcommands pathrripgte 
Nata 2 e394 bee e740 57 


Une Bpath., rxwd) Pwrite 


forseognt—).to 3 
read command 

put #path,commana 
next count 


print. this 16:an 
print. overlay 
Print. window | 
1@ goto 19 
end 

Q 

Pedy 


The program creates an overlay win- 
dow on window two with the message 
PAIS 1S an over lay au indouw. Whe 
program is similar to the window two 
program we wrote earlier. However, the 
data in the DATA sequence contains nine 
bytes. The first two bytes are the create 
an overlay window command. Phe third 
byte tells OS-9 to save the area under 
the overlay window, and restore it after 


we are finished with it (Wwe will see this 


inamoment). Phe fourth and fifth bytes 
are the *X° and *Y? location of the upper 
left-hand corner of the overlay window 


in relation to the device window (w2). 


[he sixth and seventh bytes are the “X° 
and *Y° sive of the overlay window. The 
eighth and ninth bytes are the fore- 
ground and background colors respec- 
tively. 

Notice in the BASIC program, Line 10 
calls itself. This was to stop the program 
before the END statement was encoun- 
tered. Now press the BREAK key. The 
program ts stopped, but all output to 
window two ts still appearing within the 
overlay window. kor example, let's list 
the overlay window program using the 
BASICOO fist function. From the B: 
prompt type: 


list overlay 


The overlay window program ts listed 
inthe overlay window. When you create 
an overlay window, all subsequent 
output to the device window containing 
the overlay window will appear in the 
overlay window. Phe overlay window 
must be turned off with the turn off 
overlay window command. Lo send the 
turn olf command trom BASIC09 at the 
B: prompt, type: 


$display lb 23 
Notice that OS-9 restored the original 


image that was under the overlay wine 
dow. This is because in the create an 


overlay window command we told OS- 


Y to suve the area under the overlay 
window by setting the third byte of the 
command sequence to a value of one 
I vou set this value to zero, OS-9 will 
not save the area under the overlay 
window. and thus will not restore the 
area When the overlay window ts turned 
olf. 


Implications 

Imagine using your Color Computer 
3 as a home security system, and at the 
same time tvping a letter toa friend or 
business associate. Meanwhile a large © 
language program is compiling, and a 
telecom program its downloading the 
latest stock quotes from an online 
information service, all at the same 
time. all on the same screen, and. all 
without ever having to disable the home 
security system. 

Sound impossible? The Landy Color 
Computer 3 teamed with Microware’s 
Level I] OS-9 and the Windowing 
System is designed for easy implemen- 
tation of yust such an environment. As 
we have illustrated. it is not just a fanes 
display package. Itisa powertul tool for 
both user and programmer, providing 
the real benefits of a multi-tasking 
multi-user operating system ino a 
manner that doesn’t require an assem- 
bly language applications programme! 
to implement. 
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THE COLOR COMPUTER 3: 
A PROGRAMMER’S DREAM) 





hile I was writing this article 
we the new Color Compu- 
er 3, I realized that the CoCo 


has been the same basic computer for 
Over six years! In this day of ever- 
changing computers, that’s a long time. 
True, Tandy repackaged our lovable 
little CoCo (called the Color Computer 
2), but with no real hardware or soft- 
ware changes. 

Programmers have learned how to 
push the Color Computer to its outer 
limits. But with the old CoCo hardware, 
we Just can't break any new ground. 
That’s why Tandy is introducing the 
Color Computer 3. 

The new Color Computer 3 is on the 
cutting edge of technology. The power 
of Color Computer 3 is gained by using 
a new custom chip called the GIME 
(Graphics Interrupt Memory Enhance- 
ment) in place of the older SAM and 
VDG chips. This new chip allows up to 
512K of memory controlled by a Mem- 
ory Management Unit (MMU for 
short), and a 640 by 225 super Hi-Res 
graphics screen at twice the old Color 
Computer speed. Using the analog 
RGB monitor, 225 scan lines are the 
maximum supported; however, new 
software must be written to take advan- 
tage of it. Radio Shack only supports 
192 scan lines for use with TV viewing 
devices. Not bad for one chip! 

But how can these hardware changes 
help the programmer? Take a look at 
graphics game called Marble Maze. 
Before, it was just a little too slow. But 
with twice the speed on the new CoCo, 
it is at the right pace and I am having 
a grand old time playing it! Soon we will 
see programs on this new computer that 
would have been too slow before. . 

The new text display modes are going 
to be a real help to programmers. 
Before, the text screen had only 16 lines 
of 32 characters each and no true low- 
ercase. On the CoCo 3 the text display 
mode has 24 lines and up to 80 charac- 
ters per line. Not only has lowercase 
been added, but also underlining and 
blinking attributes for each character 
on the screen. Because this is a color 
computer, the attributes also include 
eight foreground colors and eight back- 
ground colors for each character. 

With these additions, it is very easy 
to write a word processor that not only 
shows more of the text, but also shows 
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any spelling errors by highlighting them 
in red lettering. 

For a graphics programmer, the new 
graphic modes of the Color Computer 
3 are a dream come true. Not only do 
we have about four times the dot reso- 
lution, but up to 16 colors on the screen 
at one time. On the old Color Computer 
there was a maximum of four colors 
with the colors never changing in that 
mode. The Color Computer 3 has up to 
16 colors per screen with 64 colors to 
choose from. When a dot is placed on 
the screen only the color register (or 
palette) is selected. The color register 
holds the true color to be displayed. If 
a programmer wants to change all the 
red on the screen to yellow, all he needs 
to do is change that palette from the red 
to the yellow color code. 

Let’s use a picture of the New York 
sky line at day forexample. By changing 
a few color registers this daytime scene 
slowly changes to one of dusk, then to 
a nightime scene with twinkling stars. 
All of this done by a BASIC program 
using the palette command! 

One problem with a higher resolution 
display mode is it can take up to 32K 
of memory to display one screen. In just 
using two graphics screens all 64K of 
memory the 6809 can address would be 
used up. This is where the Memory 
Management Unit comes into play. 
Only one graphics screen needs to be 
addressed by the 6809 at one time, so 
the MMU is programmed to select one 
screen and place it in the 6809 address 
range. 






The new BASIC ROM in the Color 
Computer 3 takes this one step further. 
The new higher resolution display 
modes do not use any of the BASIC 
program space as did the older Color 


Computer’s graphics modes. This gives 
the BASIC programmer about 27K of 


memory (after doing a PCLEAR 1) for 
programs and variables, while still using 
a maximum size graphics screen of 32K! 


A Programmer’s Dream: OS-9 
on the Color Computer 3 

Tandy did not stop at hardware when 
they were improving the Color Compu- 
ter; it takes software to run any compu- 
ter. A more powerful and upward com- 
patible version of OS-9 called Level II 
is the real key to the power of the Color 
Computer 3. This OS-9 Level II is able 
to give each program up to 63.5K of 
memory to work in. That is a lot work- 
space on a 512K system! On the old 
Color Computer there was only 35K to 
40K to work with. 

With OS-9 being a multi-tasking/ 
multi-user operating system it would be 
kind of nice to use one screen for 
compiling a program while using 
another for editing a different program. 
By adding the Multi-View windowing 
system, it 1S aS easy as pressing the 
CLEAR key to move from window to 
window. In one window you could be 
editing a program, then in the next 
window be running a test version of the 
program, and have all debug data in yet 
another window. 
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What’s an Analog RGB Monitor Anyway? 


By Ed Ellers 


he Color Computer has had an RF 

output ever since its inception way back 

in 1980. This means the CoCo can be 
used with a standard TV set instead of a special 
monitor, and also that the display quality is 
affected by the limitations cf TV (which were 
never intended for computer displays anyway). 
Many CoCo buyers have added video output 
jacks to their computers in order to use mon- 
itors. 

Now, we have the Color Computer 3 and it 
has the same TV jack on the back panel along 
with the Channel 3/4 switch, so it still works 
with home TV sets. Tandy has also added video 
and audio output jacks to allow a factory- 
approved connection to a monitor (or to a 
VCR). It sounds like the answer to a bleary-eyed 
hacker’s dream -- but wait! On the bottom 
there's a strange seven-pin socket. What for? It 
turns out that Tandy has introduced a new 13- 
inch analog RGB monitor — the CM-8 - that 
displays the CoCo 3’s text and graphics much 
more clearly than a composite monitor can. 


RF Output 

The RF output isthe TO TV output that feeds 
into your TV set on Channel 3 or 4; the signal 
is much the same as what you would receive 
from a broadcast station or cable. The problem 
with this isn’t so much that the RF modulator 
inside the computer is distorting the signal, but 
that the tuner and especially the IF amplifier in 
most TV sets do terrible things to the incoming 
signal in the process of changing :t back into raw 
video. If you were to use an oscilloscope to look 
at the signal going into the video amplifier stages 
of your TV set and compare this with what goes 
into the modulator of your CoCo, you'd be 
surprised that the picture you see looks as good 
as it does. 

Many newer TV sets have improved circuitry 
that gives a flatter frequency response and 
causes less signal distortion, but using an RF 
hookup is still a roundabout way to do it and 
far from ideal. That’s why the more expensive 
color TV sets nowadays have video input jacks 
for better pictures from VCRs, videodisc players 


and satellite receivers; more to the point, it’s also 
why many CoCo users have ignored the RF 
output in search of something better. 


Composite Video 

Composite video is the output from a TV 
camera or from the VIDEO OUT jack on a 
VCR; it’s also what you get from a monitor 
adapter board for a CoCo, and from the video 
output on the CoCo 3. Composite means the 
signal includes horizontal and vertical syn- 
chronizing pulses and blanking pulses as well as 
video; it’s the same as the signal that goes into 
the RF modulator in the CoCo (or into the TV 
Station’s transmitter). In black and white, a 
composite signal carries a lot more detail than 
an RF signal does, and with a good mono- 
chrome monitor (which can be black and white, 
but is more often green or amber) you get very 
clear text and graphics. 

However, a composite color signal has many 
of the same problems that the RF method had. 
To squeeze three colors, which logically would 
take up as much space as three black and white 
signals, into the space of one TV channel and 
still have a useful black and white picture at the 
same time, color TV systems create a black and 
white signal from the three colors and then 
create a subcarrier to carry the added color 
information. The subcarrier can’t handle as 
much detail as is present in the monochrome 
“luminance” signal: this works out reasonably 
well for regular TV viewing, but definitely 
doesn't when you're looking at Hi-Res graphics 
at close range. 

There are also various imperfections in the 
process of separating the subcarrier from the 
luminance signal (we'll get to one of them later). 
With the Color Computer 3 there’s a better way. 


Analog RGB 

RGB simply stands for red, green and blue, 
the three primary colors of color TV and 
computer displays. This method involves send- 
ing each color signal to the monitor over its own 
wire in the monitor cable. The signals are never 
mixed together, so there’s no problem in 


separating them, and since the signals are only 
traveling a few feet there’s no problem with band 
width. 

This is the ideal way to display color graphics, 
but you do need the red, green and blue signals 
coming from the computer and a monitor that 
can handle them. The output is taken care of by 
the new GIME chip in the CoCo 3; the monitor 
is Tandy’s new CM-8, which, at $299, is quite 
a bit less expensive than the analog RGB 
monitors sold for use with Commodore’s Amiga 
and the Atari ST series computers. 

“Analog” means the voltage fed to the mon- 
itor varies with the signal level for each color. 
In a digital RGB monitor, such as the ones used 
with the Tandy 1000 and the IBM PC, the red, 
green and blue signals simply go on and off. A 
digital RGB monitor generally only shows 
sixteen colors with four signal lines; the colors 
available with analog RGB monitors are limited 
only by the computer. 

The CoCo 3 and the CM-8 monitor provide 
the best picture quality the CoCo has ever had 
— and this benefit is realized even with existing 
CoCo programs running on the CoCo 3. Com- 
paring the CM-8 with what you get on a normal 
TV is like comparing night to day. However, 
there are some minor idiosyncracies in the CoCo 
3’s RGB output. One is the lack of artifact colors 
in PMODE 4 graphics intended to run on previous 
CoCos. These red and blue colors were caused 
by the dots in the display being misinterpreted 
by the TV or monitor’s color circuits; this 
confusion just doesn’t happen with RGB dis- 
plays, so the dot patterns are now seen as dots 
instead of colors. 

Also, for some reason the colors that the 
CoCo 3 provides are seen differently on the 
RGB monitor than they are on TV sets and 
composite monitors. Because of this, Extended 
BASIC includes the PALETTE RGB and PALETTE 
CMP (composite) commands that can be used to 
switch from one mode to the other. (The pictures 
of CoCo 3 graphics shown in this issue were 
taken from the CM-8 monitor, but the program 
was configured for composite monitors.) 

The CM-8 monitor shows all the high-quality 
text and graphics the Color Computer 3 is 
capable of providing. However, those who want 
to use color composite monitors or TV sets with 
the new computer can do so, just as they did with 
previous CoCos. The CM-8 monitor can be 
added at any time. 7 \ 
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Each window can be in text or graph- 
ics modes and can take up all or only 
part of each screen. You can even put 
several windows on the same screen 4s 
long as they don’t overlap. | 

If that is not enough to get a pro- 
grammer drooling, there is a full point- 
and-click interface with drop-down 
menus built into the Multi-View pack- 
age. A full set of graphics drawing 
commands like LINE, BOX, FILL, CIR 
CLE, ELIPSE and GET~’PUT buffers are 
included to round out the package. 

The Multi-View package holds most 
of what a programmer needs to do 
programs like the CoCo Max. As a 
matter of fact, this package already has 
about 80 percent of the code that Tim 
used in that landmark program for the 
older Color Computers. It will not be 
long before we see many top of the line 
drawing programs under OS-9. 

This is one programmer's view of-the 
Color Computer 3. It has a lot of what 
we've been asking Tandy for in the way 
of power. So, I better get back to work; 
I have a few programs to develop that 
will knock your socks off! lA 


Two-Liner Contest 
Winner... 


The listing: 


® POKE65495,6:DIMH(2,2) : PMODE3 
,1:PCLS: DRAW"BM122 , 99USR1PUG6R8D4 
L2D16L4U3 L8D3L4":GET(99,83)-(121 
,191),H,G:PCLS:SCREEN1,@:FORX=1T 
O191STEP27:PUT(,X)-(31,X+18) ,H, 
PSET: U=U+1:P(U) =X:NEXTX: DRAW"C3" 
: LINE (248,8)-(255,191) , PSET, BF:E 
XEC44539: PLAY"O3L18CL4F" 

1 FORX=1T07:M(X) =M(X)+RND(19) : PU 
T(M(X) , P(X) )-—(M(X)+31,P(X)+18) ,H 
,PSET: IFPPOINT (M(X)+33,P(X)+9) <> 
1THENPLAY"03L115CDDEFFGAAB": FORT 
=1T019: PUT (M(X) , P(X) )-(M(X)+31,P 
(X) +18) ,H, PRESET: PUT(M(X),P(X))- 
(M(X)+31,P(X)+18),H,PSET:NEXTT:E 
XEC44539 : RUNELSENEXTX:GOTO1 


And they’re off! Pick a 


horse to win out of a field 
of seven. If you press 
ENTER when they are at 
the line, the horses will 
run. You and your friends 
can then pick the horse 
you want. 


Mike Cooney 
Mansfield, OH 
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Rational Thinking 


atios is a hands-on exercise in 
Pxiwerie fractions to ratios 

and percentages; the sort of 
exercise which enables a pupil to in- 
crease familiarity and skill by means of 
unlimited repetition. 

If you enter the numerator and the 
denominator of a fraction, you have 
control over the level of difficulty. If you 
let CoCo enter random numerators and 
denominators, the level of difficulty is 
controlled by the magnitude of the 
numerator you choose (Line 370). In 
either case, the numerator is restricted 
to two digits and the denominator to 
three, which keeps the program within 
the ability limits of a disadvantaged 
pupil. Increase the level of difficulty by 
changing the values of LEN(AS) and 
LEN(8S) in lines 130 and 140 and 





198 CLS:GOTO239 

26 X=B/A:GOTO49 

38 X=(A/B) *19p 

49 XS$=STRS$(X) 

59 ES=STR$(E) : EX=LEN(E$) -LEN(STR 
$ (INT (E) )) 

69 IFE=INT(E) ANDX<>INT(X) THENPS= 
LEFTS (X$,5) ELSEP$=LEFT$ (X$, LEN(S 
TR$ (INT (X) ) ) +EX) 

76 RETURN 

89 IFES=PSTHENR=R+1: PRINT@268,"R 
IGHT!":AS="—ANSWER WAS"+P$: PRINT@ 
393-INT(LEN(A$) /2) ,A$;: IFQ=1THEN 
PRINT" $%"': GOTOLSHELSE1B9 

98 IFE$<>PSTHENWR=WRt+1: PRINT@268 
,"WRONG!":AS="ANSWER WAS"+PS$: PRI 
NT@393-INT(LEN(AS$)/2) ,A$?: IFQ=1T 
HENPRINT"$" 

196 AS=STR$(R)+" RIGHT OUT OF"+S 
TRS (R+WR)+" "+CHRS (8) : PRINT@336- 
INT(LEN(A$)/2) ,AS+"1" 

119 IFR>STHENE=(R+WR) /R: IES="THA 
T IS 1 :"+LEFTS$(STRS$(E),5)+" OR" 
+LEFTS (STR$(R/ (WR+R) #199) ,6)+"%" 
: PRINT@367-INT(LEN(IE$)/2) , IE$ 
129 RETURN 

139 LINEINPUTAS:A=VAL(AS) : IFA<>I 
NT (A) ORLEN (A$) >2THENPRINT@139,CH 
R$ (31) : PRINT@139,""'; :GOTO13 SELSE 
RETURN 

149 LINEINPUTBS: B=VAL(BS) : IFB<>I 
NT (B) ORLEN (B$) >3THENPRINT@194, CH 
R$ (31) : PRINT@194,""; :GOTOL4SELSE 
RETURN 

159 LINEINPUTC$: IFLEN (C$) >7THENP 
RINT@169+L+9, CHR$ (8) : PRINT@169+L 
+9,""> : GOTOLSSELSEC=VAL(C$) : RETU 
RN 

169 LINEINPUTDS$: IFLEN(D$) >7THENP 
RINT@16$+L+LC+12, CHR$ (31) : PRINT@ 
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VAL(CRS) in Line 370. After five at- 
tempts, you are given the choice of 
entering your numbers or random 
numbers again. 

In entering answers to questions, you 
are restricted to seven characters includ- 
ing a decimal. Illegal entries are erased 
and a new-entry can be made. The 
instructions ask you not to type the 
percent (%) sign because this is added 
to your answer. 

After an answer has been entered, the 
screen shows either RIGHT or WRONG and 
the correct answer in both cases. The 
entries in lines 50 and 60 ensure that 
CoCo’s correct answer (P$) is the same 
length as your correct answer (E5). If 
you enter 33.3 as the percentage equiv- 
alent of '/;, then you get ANSWER WAS 
33.3%. If you enter 33.3333, then 


166+L+LC+12,""; :GOTO16SELSED=VAL 
(D$) :RETURN 

179 FORX=P TO P2STEP32:PRINT@X,C 

HRS$ (31) :NEXT: RETURN 

188 IFLEN(A$) >LEN(B$) THENL=LEN (A 
$) ELSEL=LEN (B$) 

198 PRINT@162,STRING$(L,"-")" = 
1 :"3;:RETURN 

262 FORD=1T01599: NEXT: RETURN 

219 PRINT@487,"PRESS ANY KEY."; 
228 K$=INKEYS: IFKS$=""THEN22$ELSE 
RETURN 

238 CLEAR299 

249 PRINT@139,"<RATIOS>",,,,,"BY 
KEIRAN KENNY, THE HAGUE, 1985" 
25 PRINT@329,"<ENTER> YOUR NAME 
, PLEASE (MAX. 14 CHARACTERS==>" 
;: LINEINPUTNMS 

269 IFLEN(NM$) >14THENP=329: P2=41 

6: GOSUB17$:GOTO259 

278 PRINT@422,"INSTRUCTIONS? Y/N 
We 

286 

296 

329 


GOSUB229 
IFK$="Y"THENCLS : GOTO649 
IFK$="N"THENCLS : GOTO3 29 

316 GOTO28¢9 

328 PRINT@128,"MAKE YOUR CHOICE: 
"; PRINT: PRINTTAB(5)"rANDOM NUMBE 
RS, OR": PRINT: PRINTTAB(5) "eNTER 
YOUR OWN NUMBERS.": PRINT: PRINTTA 
B(5)"PRESS <R> OR <E>3:'"3 

339 GOSUB229 

349 IFKS$="R"THENX=RND(-TIMER) :V= 
1: PRINT"R" :GOTO379 

359 IFKS$="E"THENV2$: CLS:GOTO389 
369 GOTO339 

376 PRINT: WS=NM$+" WANTS A NUMER 
ATOR": PRINT@499-LEN (WS) /2,W$: PRI 
NT@456,"NO LARGER THAN:"s3:LINEIN 
PUTCR$: IFVAL(CR$) <1ORLEN (CR$) >2T 
HENP=448 : P2=448 :GOSUB179: PRINT@4 
48,""': :GOTO37PELSEGOSUB2£f:CLS:G 
OTO492 

389 CLS: IFKS="E"ORKS="Y"THENPRIN 
T@32,"ENTER NUMERATOR (THE TOP N 
UMBER IN A FRACTION)."* 
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CoCo’s correct answer will be 
33.3333%. If your answer is wrong, then 
CoCo’s correct answer may vary in 
length. This is followed by an X RIGHT 
OUT OF Y message and a score expressed 
as a ratio and a percentage in keeping 
with the theme of the exercise. 

All the subroutines are at the begin- 
ning of the listing in lines 20 through 
220. This should make it easier if you 
want to use them 1n your own programs. 
Change Line 20 to read X=A/B and Line 
190 to read PRINT@162,STRINGS 
(L, ae ate :RETURN and you have a 
basis for using the fraction for division 
exercises beginning at Line 240. Note 
that lines 180 and 190 ensure the frac- 
tion line has the length of whichever of 
the two, numerator or denominator, is 
longer. 


398 PRINT@139,""3:GOTO419 

499 IFK$="R"ORK$="Y¥"THENA=RND (VA 

L(CR$) ) s:AS=RIGHTS (STR$(A) , LEN(ST 

R$ (A) )-1) : PRINT@139,A$:GOTO449 

418 GOSUB13$: P=32: P2=64:GOSUB179 

429 PRINT@32,"ENTER DENOMINATOR 
(THE BOTTOM NUMBER)." 

436 PRINT@194,""3:GOTO469 

449 B=A+RND(VAL(CR$) ) 

459 BS=RIGHTS (STR$(B) , LEN(STR$(B 
))-1) sPRINT@194, B$:GOSUB189:GOTO 
499 

466 GOSUB14$:GOSUB189 

479 IFB<A THENPRINT@224,"TOO SMA 
LL! TRY AGAIN! ":GOSUB299: P#194:P 
2=224:GOSUB179:GOTO439 

489 P=32:P2=64:GOSUB179 

49% PRINT@32,"ENTER NUMBER AFTER 
COLON (WITH DECIMAL WHERE NECE 
SSARY). 

599 PRINT@LED+L49, "7 :P=3292GOSU 
B159:E=C 

51 GOSUB2$:GOSUBB¢ 

529 PRINT@32,"ENTER THE EQUIVALE 
NT PERCENTAGE (WITH DECIMALS IF 
NECESSARY) ."' 

539 LC=LEN(C$) : PRINT@169+L+LC+19 
,"= "::GOSUB169: PRINT@169+L+LC+1 
1+LEN (STR$(D)),"%"sE=D 

546 GOSUB3$: P=256: P2=352:GOSUB17 

9:Q=1:GOSUB89 

559 PRINT@457,"ANOTHER? Y/N" 

569 GOSUB229 

579 IFKS$="¥"AND(R+WR) /5=INT ( (R+W 

R) /5) THENQ=9: CLS : GOTO329 

589 IFK$="Y"ANDV=1THENCLS : Q=9:GO 
TO4PfA 

398 IFKS$="Y¥"ANDV=STHENQ=9 : GOTO38 


699 IFK$="N"THENCLS : GOTO629 

619 GOTO569 

629 TKS="THANKS "+NM$+"1":; PRINT 
112-INT (LEN (TK$) /2) , TK$: PRINT@16 
9," I HOPE YOU LIKED THE TEST AN 
D LEARNED SOMETHING FROM IT.": 
PRINT@455,"TO END PROGRAM" :GOSUB 


ee 


21 

639 CLS: END 

649 PRINT@7, "***INSTRUCTIONS# #*" 
: PRINT@32,""GIVEN THE NUMERATOR ( 

THE TOP NUMBER) OF A FRACTION 
LIKE THIS:": PRINT@191, CHRS$ (159) 
: GOSUB2£p 
658 PRINT@199,3:GOSUB2Pf: PRINT@S 
6, CHR$ (31): PRINT@85,";" 

669 PRINT@96,"THEN THE DENOMINAT 

OR (BOTTOM NUMBER), LIKE THIS 
:": PRINT@164, 3: PRINT@197, "=": PRI 

NT@229, CHR$ (159) :GOSUB299 

679 PRINT@228,4:GOSUB29$: PRINT@1 

35,CHR$(31) :PRINT@135, "3" 

689 PRINT@169,"<ENTER> THE NUMBE 

R AFTER THE COLON (':') LIKE 

THIS: ": PRINT@228,3: PRINT@261, "- 

= 1 : "4+CHR$(159) : PRINT@292,4:GO 

SUB2p9 

699 PRINT@268,1.33:GOSUB296: PRIN 

T@294,CHR$ (31) : PRINT@293,";" 

706 PRINT@224,"AND THEN CONVERT 

THE FRACTION INTO A PERCENTAGE 
LIKE THIS:":PRINT@292,3: PRINT@3 
25,"= = 1 : 1.33 = "+CHRS$(159):P 

RINT@356, 4:GOSUB299 

716 PRINT@349,"75%": PRINT@416, "I 
'M NOT GOING TO TELL YOU HOW TOD 

O YOUR ARITHMETIC! ":K$=INKEY$S:GO 

SUB219 

726 CLS:PRINT@$,"YOU CAN <ENTER> 
YOUR OWN NUMBERSABOVE AND BELOW 
THE LINE OR LET THE COMPUTER EN 

TER A NUMERATOR AND A DENOMINAT 

OR AS RANDOM NUMBERS. IN THI 

S CASE YOU CAN CHOOSE THE HIGH 

EST VALUE FOR THENUMERATOR (MAXI 

MUM 99)." 

738 PRINT: PRINT"BEGIN WITH SMALL 
NUMBERS AND TRYTO CALCULATE THE 
ANSWERS IN YOURHEAD AS AN EXERC 

ISE IN MENTAL ARITHMETIC. TRY 

LARGER NUMBERS TOO AS AN EXERCI 

SE IN USING YOURCALCULATOR OR IN 
MAKING CALCUL- ATIONS ON PAPER. 

":GOSUB219 

749 CLS:PRINT@9,"<ENTER> NUMBERS 
AS FOLLOWS: ": PRINT: PRINT"NUMERA 

TOR, 1-2 DIGITS, NO DECI- MAL. M 

AXIMUM 99;" 

758 PRINT: PRINT"DENOMINATOR, 1-3 
DIGITS, NO DEC-IMAL. MAXIMUM 99 

Q9;" 

768 PRINT: PRINT"ANSWERS, MAXIMUM 
WITH DECIMAL SEVEN CHARACTERS 
. DO NOT TYPE THE '%! SIGN." 

778 PRINT: PRINT" ILLEGAL ENTRIES 

WILL SELF-ERASE AND YOU CAN TRY 

AGAIN!" 

788 GOSUB219:CLS:GOT0O329 





HARDWARE PROJECT 





Do-It-Yourself 
Video Output 


Board 


By Tim McIntosh 


a daily basis. The bulk of my work 

revolves around word processing. I 
quickly discovered that using a televi- 
sion for a monitor was inadequate. 

About a year ago, I began to look 
around fora monitor and a way to drive 
it. I was unaware of the many advertis- 
ers who market just such devices. So, I 
set out to build my own. The project 
presented here required about a half 
day’s labor and $8 worth of parts. 

As the schematic shows, this monitor 
driver requires two common transistors 
and a handful of support components. 
Most experimenters should have an 
abundant supply of these. The driver 
works with color as well as mono- 
chrome composite video monitors. The 
pin numbers given in the schematic refer 
to the MC6847 VDG chip in the Color 
Computer. The descriptions of these 
pins are as follows: Pin | — GND 
(signal ground); Pin 17 — Vcc (+5v 
DC); and Pin 28 — Composite video 
signal. 

Construction of the driver is rela- 
tively simple. I used a small project 
board from Radio Shack to mount the 


[= my CoCo quite extensively on 


Video Board Schematic 


05,F 


Composite PIN 26 
Video 
Input ° 


PIN 1 1 
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components. I ran the connecting wires 
(any standard jumper wire will do) to 
the points on the circuit board where the 
6847 is soldered. Be careful when count- 
ing to the proper pin locations. A 
mistake could damage your CoCo. 

Many of you will want to run a length 
of shielded cable with an RCA plug on 
it out of the computer directly to the 
monitor. I chose to tidy up the project 
by mounting an RCA jack on the back 
of the CoCo and running the shielded 
wire to this. Not only did this improve 
the appearance of the project, but I can 
now relocate my CoCo without trailing, 
a mess of wires behind me. 

Although I use this new monitor 
driver on a CoCo 2, it should work on 
any Color Computer as well. Re- 
member: Opening your CoCo voids the 
warranty. It is not advisable to attempt 
this project without some prior knowl- 
edge of electronics. 

(Any questions you may have about 
this project can be sent to the author at 
416 Oak St., Greenville, AL 36037, 205- 
382-7358. Please enclosean SASE when 
writing.) 

(AN 
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SIMULATION 








by Michael 
B. Kromeke 


his program allows vou to see 
some of the internal workings of 
a running engine. Phe engine ts 


started by pressing “S*. As it starts, the 
car key moves into the izmition switch 
and turns. The oil warning light comes 
on, the fuel gauge goes from empty to 
full, the fan starts to turn and the oil 
warning light goes off. Phe four pistons 
start moving up and down and the spark 
plugs tire. 

When the engine is running, press “17 
fora trouble selection. This puts one of 
five troubles into the engine in random 


Variables 

A = answer 

B = miscellaneous counter 

Cl = cylinder | 

C2 = cylinder 2 

C3 = cylinder 3 

C4 = cylinder 4 

D = number of trouble 

E = oil leak counter 

F = vertical location of cylinder 

G = picture of piston 

H = picture of key in slot 

1&M = trouble in engine 

R = number of right answers 

W = wrong answer counter 

Y = horizontal location of 
cylinder 

A$ = draw picture of fan not 
turning 

ZS = miscellaneous input 


and information about that kind of 
trouble is displaved. You will be told 
whether vou have correctly identified 
the problem or not. 

If an incorrect answer is picked, you 
are sent back for another look at the 
trouble. A correct answer returns vou to 
a properly running engine. After cor- 
order, You must try to start the engine 
again. Tfit tails to start or does not run 
properly, vou must go to the checklist 
by pressing °C’. 

The checklist gives TT different pos- 
sibilities. Choose one of the possibilities 


rectly finding all five troubles, your 
score and skill level are displayed. The 
three skill levels are beginner, shade tree 
mechanic and master mechanic. 


Anytime the engine is running, even 
improperly, you may stop and Start it 
by pressing *S’. 


fo run this program with only 16K, 
delete all REM statements. Deleting the 
following lines will not affect the pro- 
gram: 30, 34, 38, 42, 48, 70, &4. &&, 92, 
96, 100, 106, 112. 120, 176, 180, 184, 1&8 
and 216. 








FUEL Oil 


EF [os 


WOLTS KEY 
diz C 


PRESS 'T’ FOR TROUGLE 


** CHECK LIST %** 


1) MISSING U-JOINTS 
2) FUEL TANK EMPTY 
3) ROTATE TIRES 

4) BATTERY IS DEAD 


5) REPLACE MASTER CYLINDER 


6) SPARK PLUG NOT FIRING 





The Listing: ENGINE 


2 CLEAR200: DIM A,B,C1,C2,C3,C4,D 
,E,F,G(7),H(18),1,M, R: Cl=12: C2=3 
:C3=9: C4=6: B=RND(-TIMER) 

4 GQSUB196: GOTO50 

6 ON F GOSUB36, 40, 44, 40, 36, 32, 36 
»40, 44,40, 36, 32: RETURN 

8 SCREEN1: Y=0: F=C1: GOSUB6: C1=C1+ 
1: 1F C1=13 THEN DRAW’ BM86,51C4ND 


Page 24 * Australian Rainbow 
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2": PLAY" T255A": GOSUB28: DRAW'C1IND 
2":C1=1 

10 Y=23: F=C2: GOSUB6: C2=C2+1: IFC2 
=13 AND D<>3THEN DRAW’BM109, 51C4 
ND2": PLAY" A": GOSUB28: DRAW’ C1NDe"' 
:C2=1 

12 IF C2=13 THEN C2=1 

14 Y=46: F=C3: GOSUB6: C3=C3+1: IFC3 
=13 THEN DRAW" BM132,51C4ND2": PLA 
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7) FLUSH COOLING SYSTEM 
8) OIL LEAK 

9) CATALYTIC CONVERTER 
19) AIR INTAKE BLOCKED 
11) OIL PRESSURE LOW 
CHOOSE ONE OF THE ABOVE 


Y" A’; GOSUB28: DRAW" CIND2" : C3=1 

16 IF D=4 THEN PSET(126+RND (44), 
112+RND(7),2): E=E+1: IF E>100 THE 
N: PAINT (80, 144),4,3: SOQUND2, 20:GO 
TO220 

18 Y=69: F=C4: GOSUB6: C4=C4+1: IFC4 
=13 THEN DRAW"BM155,51C4NDe": PLA 
Y" A": GOSUB28: DRAW" CINDe": C4=1 

20 Z$=INKEYS: [FZ$="" THENS 

ee IF Zt="T" AND D=OTHEN [=I+1: D= 
M( 1): GOTO50 

c4 IF Z$="C"AND D<>0 THEN122 

29 IF Z$="S"THEN116 ELSES 

28 FORB=1T0100: NEXTB: RETURN 

30 'CYLINDER MOVEMENT POSITION 1 
3¢e PUT (80+Y,55)-(92+Y,71),G, PSET 
: RETURN 

34 'POSITION 2 

36 PUT (80+Y,59)-(92+Y,75),G, PSET 
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: RETURN 

38 "POSITION 3 

40 PUT (80+Y,63)- (92+Y, 79),G, PSET 
: RETURN 

42 'POSITION 4 

44 PUT (80+Y,67)-(92+Y, 83) ,G, PSET 
: RETURN 

46 PRINT@488," PRESS <RETURND"; :L 
INEINPUTZ$: RETURN 

48 'MAIN SCREEN 

50 PMODE3, 1: PCLS: SCREEN1, 0: DRAW” 
BMO, OC2R255D120L255U120BM70, 46C4 
R1OOD40L1LOOU4OH4AU4SE4R1IOOF4D4AG4L4 
ABUICULOR2ZOFAUBSH4AL60G4L16HeL2D12 
R2EZRI6F4RIONR22D190BM0, 191 R255" 
S92 A$="BM650, 68C3H10U14E4F4D14G8D 
4FANE4G4D14F4E4U14H4": DRAW’ BM70, 
86C4D6F4R40FODOFZR4ACLAD2L3UCRSOES 
U18BM70, 60L10D14NR10": DRAW” XA$; B 
M154, 34RU1LCE4R4F4D12BM130, 94NR4D 
ORAUSBRADSBRANUSR3BLI4BD4NDSOR4D2 
NL4BR4ANR4D3U5SR4DSBRAUSFSU5" 

54 DRAW’ BM36, 28C2NR4D2NR4D3BR8U5 
R4D2NL4D3BR4U5RFOUSBMS4, 19C4U3NR 
AUZR4ADSPRAUSBRANDSR4AD2LAUFABROUS 
BR4NDSRFOUSBR4AR2NDOR2BR4ANDSR4AD2N 
LADSBR4US3R2NF3NE2LZU2BRENR3D2NR2 
D3R3"" 

56 DRAW'BM204, 98C4R40D18L40U18R6 
U2R4AD2RAUZR4ADZR4AUCRADZRAUSRAD?|SL3 
OBD6NDEC3RAD3NL4D3NL3BR4U6R4D3NL 
4D3BR8U6L2R4BR4R4L2D6BR4R1” 

58 DRAW’ BM78, 79C4U25R16D25BR7U25 
R16D25BR7U2Z5R16D25BR7U25R16D25EM 
86, 50C3R68E8U18L2D18G7L44BM14, 64 
C3E8NROE4S NROEBR6G20L6D40RGNU4 OE? 
0U39": POKE178, 207: PAINT (34,55),, 
3: POKE178, 3: GOSUB86 

60 DRAW’ BM14, 126C3NR4D3NR2D3BREN 
U6R4U6BR4ANR4AD3NR2D3R4BRANR4AU6BR3 
4D6R40U6NL4BR4D6BR4NU6R4BR32H2U4B 
RSD4GSBRGONR4U6R4 D6 BR4NUOR4BRAUVON 
LERCBRANRADSR4D3L4BM8, 1S8NR4D3NR 
2D3R4" 

62 DRAW’ BR32USNRZUCR4BRI8NR26D12 
R26UIZBRISNRADGRAU3LAU3BR24BU4NR 
AD3R4NU3D3NL3BR20BDAUGBR4AR4D3L4D 
SR4BM26, 164C2H16BM214, SACAND8R12 
D2eNLI2D6LICROD4BR3U6GL3D2" : GET (21 
4,50)- (226, 66),G,G: LIVE(214,50)- 
(226,66), PRESET, BF 

64 DRAW’EM136, 164C2": IF D=2 THEN 
DRAW" H16" ELSEDRAW" E16" 

66 CIRCLE (220, 58),14,3, .9: DRAW"B 
M212, 64C3NE14F3E14": PAINT (220,58 
», 4,3: GET (206, 46)- (234,70) ,H,G:L 
INE (206, 46) - (234,70), PRESET, BF: G 
OSUB102 

68 IF D=5 THEN PAINT(64,20),2,4: 
GOTQ182 

70 'START ENGINE 

72 IF INKEY$<>"S"THEN72 ELSEGOSU 
B90 

74 IF D=1 THEN186 

76 IF D=2 THEN178 

78 GOSUB94: FORB=0TOS2STEP3: LINE ¢ 
50, 42+B)- (58, 42+B) , PRESET: PLAY" T 
14001 AF": NEXTB: PAINT (80, 144),1,3 
: GOSUB98 

80 IF D=3 OR D=4 THEN GOSUB108 E 
LSE GOSUB114 

82 GOTOS 

84 'DRAW KEY,CIRCLE & WORD KEY 
86 CIRCLE(190, 140),14,3,.9: DRAW" 
BM188, 150C3U20R4D20BRCONHAE4F4E4 
R6FORGEGU4HOLOG6L22ND4ABR29BD2ZER2 
F2G2L2H2BL24BU12C2ZV6D3R2NESF3BR6 


NRAUSNREUSR4ABR4AD2RANUCLZDA": PAIN 
T (216, 144),2,3: RETURN 

88 '’KEY TQ START POSITION 

90 LINE (208, 135)- (248, 153), PRESE 
T, BF: PLAY" T8QAPRCDEF”: PUT (176, 128 
»- (204,152),H, PSET: RETURN 

92 'FUEL GAGE FROM E TO F 

94 PAINT (80, 144),4, 3: GOSUB28: DRA 
W" BM26, 164C1NH16" : GOSUB28: DRAW"C 
2NUY16" : GOSUBZ8: DRAW'C1NU16": GOSU 
B28: DRAW’ C2E16” : GOSUB28: RETURN 

96 'BLANK BOX 

98 LINE (44, 176)-(255, 190), PRESET 
» BF: RETURN 

100 *DRAW PRESS S FOR START 

102 DRAW'BMO, 182C3ND6R4D3L4D3BR8 

U6R4D3L4R2F3BRANR4USNR2U3R4BRANR 

ADSR4ADSNLABR4RAUZLAU3R4BRENDCBR4 

NR4AD3RAD3NLABR4BU4U2ZBR8R2NR2D6BR 

ONR4U6R4 D6 BROBUGNRADSRADSNL4BROU 

6L2R4BRANDGR4AD3NLADSBRAUGR4D3L4R 

cF3BR6U6L2R4" 

104 DRAW" BR8NR4D6R4U6BR4NDO6R4D3L 

ARF3BRIOBUONR4AD3SR4D3NL4 BR6U6L2R4 

BRANR4DOR4U6BR4ANDOR4D3L4": RETURN 
106 'DRAW C FOR CHECK LIST 

198 DRAW’ BM45, L82¢C3NDZBR4NR4D6R4 

BR4BU4UCBR7 NR4D3NR3SDSBREBNRAUGRAD 

6BRAU6GR4D3L4R2FS3BRIONR4AV6R4BR4D3 

NRADSBRAUGBRANR4D3SNR2D3IRABRANRAU 

6RABR4AD3RENE3NFSL2D3" 

110 DRAW’ BRIGNU6R4BRAUGBRANR4D3R 

AD3NL4BROU6NL2RO": RETURN 

112 'DRAW T FOR TROUBLE 

114 DRAW’BM45, 182C3ND2BR4R2NRODS 

BROBU4UCBR7 NR4ADSNR2DIBRENR4AVGR4AD 

6BRAUBRAD3LARCFSBRIZUENL2R2BRAND 

6RAD3LARF3BRANR4UGR4D6BR4ANUGRAUG 

BR4D6R4U3NLAUSNL4BRAD6RABRANRAUS 
NR3U3R4": RETURN 

116 DRAW" XA$; BM26, 164C1NE16": GOS 

UB28: DRAW" C2NU16” : GOSUB28: DRAW" C 
1NU16C2H16": LINE (176, 126)- (250, 1 

52), PRESET, BF: GOSUB98 : GOSUB86: GO 

SUB102: GOTO72 

118 PRINTC487," PRESS <RETURND "; 
: LINEINPUTZ$: RETURN 

120 'CHECK LIST 

122 CLS: PRINT@8, "xk CHECK LIST * 

x": PRINT@68,"1) MISSING U-JOINTS 

";PRINT@100,"2) FUEL TANK EMPTY” 
124 PRINT@132,"3) ROTATE TIRES”: 

PRINT@164,"4) BATTERY IS DEAD” 
126 PRINT@196,"5) REPLACE MASTER 
CYLINDER": PRINT@228,"6) SPARK P 

LUG NOT FIRING” 

128 PRINT@260,"7) FLUSH COOLING 

SYSTEM": PRINT@292,"8) OIL LEAK” 
130 PRINT@324,"9) CATALYTIC CONV 
ERTER"”: PRINT@355,"10) AIR INTAKE 
BLOCKED" 

132 PRINT@387,"11) OIL PRESSURE 
LOW’ 

134 PRINT@450,"CHOOSE ONE OF THE 
ABOVE”; : INFUTZ$: A=VAL (Z$) 

136 IF A<1 OR A>11 THEN SOUND1,1 
:GOTO0134 

138 ON A GOTO140, 142, 146, 150, 154 
, 156, 160, 164, 168, 172,174 

140 CLS: PRINT@4,"**k MISSING U-JO 
INTS *k": PRINT@65, "THE U-JOINTS 
CONNECT THE DRIVE- SHAFT TO THE 
DIFFERENTIAL WHICH TURN THE WHEE 
LS. THE U-JOINTS ARE NOT IN TH 
IS PROGRAM .":GOTO190 

142 CLS: PRINT@6,"** FUEL TANK EM 
PTY *k": PRINT@65,"*LOCATED ON THE 


LEFT SIDE OF THE SCREEN, THE E 
STANDS FOR EMPTY AND F STANDS F 
OR FULL. GASOLINE IS MADE FROM P 
ETROLEUM THAT IS A NATURAL FLAM 
MABLE LIQUID” 

144 PRINT” HYDROCARBON MIXTURE T 

HAT COST AN ARM AND A LEG.":GO 

T0190 

146 CLS: PRINT@6,"** ROTATE TIRES 
*x": PRINT@65,”", YOU CAN INCREASE 


THE LIFE OF YOUR TIRES BY ROT 
ATING THEM ONCE EVERY 5000 M 
ILES OR SQ. CARS WITH FRONT-W 
HEEL DRIVE SHOULD NOT BE ROT 
ATED. TO GET MAXIMUM TIRE LIFE 
YOU SHOULD" 
148 PRINT” CHECK AIR PRESSURE EV 
ERY 30 DAYS WHEN TIRES ARE C 
OLD FOR MANUFACTURER RECOMMEN 


DED PRES- SURE.”:GOQTO190: GOSUB 

118 

150 CLS: PRINT@6,"*xk BATTERY IS D 
EAD *#": PRINT@65,”" THIS CAR IS RU 
NNING ON A 12 VOLT SYSTEM. C 
HECKING THE VOLTAGE READIN 
G ON THE INSTRU- MENT PANEL WE 

CAN SEE IF WE HAVE THE PROPE 
R READING. ANY- THING ABOVE 9. 
6 VOLTS AFTER 15" 

152 PRINT" SECONDS OF CRANKING T 
HE ENGINE SHOULD BE ADEQUATE.": 
GOTQ190 

154 CLS: PRINT@2,"*k REPLACE MATE 
Kk CYLINDER *k": PRINT@65,"THE MAS 
TER CYLINDER 1S NOT SHOWN | 
N THIS DIAGRAM. IT IS A VERY IM 
PORTANT PART OF THE BRAKE S 
YSTEM.": GOTO190 

156 CLS: PRINT@2,"*k SPARK PLUG N 
OT FIRING kk"; PRINT@65,"THE IGNI 
TION SYSTEM IS DESIGNED TO IGHIT 
E THE AIR/FUEL MIXTURE THAT IS 

DRAWN INTO THE ENGINE THROUGH 

THE CARBURETOR. IF THE SPARK PL 
UGS FAIL TO FIRE THEN" 

158 PRINT” YOUR ENGINE WILL NOT 

RUN PROP- ERLY.":GOTOQ190 

160 CLS: PRINT@2,"** FLUSH COOLIN 
G SYSTEM *«*": PRINT@65,"THE COOLI 


NG SYSTEM SHOULD BE DRAINED A 
ND FLUSHED EVERY TWO YEARS, AN 
D NEW COOLANT ADDED. THE RADIA 
TOR IS SHOWN IN THIS DIAGRAM A 


ND HELPS KEEP THE” 

162 PRINT” ENGINE FROM OVER HEAT 
ING BUT DOES NOT EFFECT ITS R 
UNNING.": GOTO190 

164 CLS: PRINT@9,”"xkk OIL LEAK xx" 
: PRINT@65,""KEEP YOUR EYES ON THE 
OIL PAN . IF IT STARTS TO LEAK 
WE WILL SEE THE OIL WARNING L 
IGHT COME” 

166 PRINT” ON JUST BEFORE THE EN 
GINE FREEZES UP,DO TO LACK 
OF", LUBRICANT." : GOTO190 

168 CLS: PRINT@3,"**k CATALYTIC CQ 
NVERTER ¥*k": PRINT@65,"THIS UNIT 
CONVERTS HYDROCAR- BONS AND C 
ARBON MONOXIDE INTO CARBON DIO 
XIDE AND WATER VAFOR. EXPECTED S 
ERVICE LIFE IS ABOUT" 

170 PRINT” 50,000 MILES AND IS N 

OT IN THIS PROGRAM.": GOTO190 

172 CLS: PRINT@3,"*k AIR INTAKE B 
LOCKED *x": PRINT@65,"THE AIR CLE 
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HARDWARE PREVIEW 


Gaia 
Pree 


NEW YORK, JULY 30 — 


After anticipating the new Color 
Computer for more than a year, the 
finished product is more than well 
worth the wait. The new machine is 
called a Color Computer 3 (not partic- 
ularly surprising) but it might be called 
Warp Factor 3 instead. 

First, the obvious things. The CoCo 
3 general specifications go something 
like this: 

e {28K RAM standard, upgradable 
to 512K in one step only. 

e 64 different colors, 16 available at 
a time. 

e Graphics resolution of 640 by 192. 

e Standard Microsoft BASIC, Ex- 
tended BASIC and Disk BASIC, with a 
number of very fancy enhancements 
written by Microware Systems Corp. 
(the OS-9 people). 

@ A new keyboard much the same as 
the deluxe keyboard now offered (with 
a CONTROL and ALTERNATE key and 
two function keys), but with a newly 
designed cursor keypad in a diamond 
configuration. 

e A slightly new color scheme for the 
case, using the now-familiar cream 
color and a light gray around the edge 
of the keyboard. 

e A choice of 32, 40 and 80 column 
widths with upper- and lowercase and 
true descenders. 

¢ Fully compatible with all the soft- 
ware you own now. The caveat to that 
is software writers cannot have made 
undocumented calls to the ROM. 
Tandy developed guidelines for soft- 
ware developers years ago — if authors 
followed those “rules,” their software 
will work with CoCo 3. 

© OS-9 Level II operating system for 
a true multi-tasking, multi-using envi- 
ronment. More on this later. 
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¢ Fully compatible with all the hard- 
ware you own now. Just unplug your 
disk drive, tape recorder, printer and so 
on, replace your present “box” with a 
CoCo 3, and plug everything in again. 
It all works. (There will be a small 
problem running OS-9 with older mod- 
els of the Multi-Pak Interface. Tandy 
will make the fix for about $6, excluding 
installation.) 

¢ A new interface for a new analog 
RGB monitor available from Tandy. 
The new monitor’s color scheme 
matches the CoCo 3. 

e Retail price: $219.95. 


On the surface, these changes are 
pretty exciting, but not astounding. Yet 
CoCo 3 is an astounding machine. It is 
not the changes in the specifications so 
much as what has been done with the 
specifications that makes the CoCo, 
once again, the best possible computer 
buy for the home or small business 
market, bar none. 

An example: Combining the new 
analog RGB monitor (a CM-8 by Tan- 
dy’s designation) and CoCo 3, the 
resolution on graphics screens appears 
better than that of an MS-DOS 
computer. Why? By using analog tech- 


nology, the resolution appears to be of — 


higher quality than it really is. I can see 
software writers frothing at the mouth 
to get at this stuff. 

Another example: The CoCo 3 can 
run at about 2 megahertz, unlike the 
CoCo and CoCo 2. But, by designing 
and building a special chip, called a 
GIME Chip, effective speed is increased 
even more. In a quickie benchmark we 
performed here, CoCo 3 animation 
zapped an IBM PC and a Macintosh. 
CoCo 3’s bouncing ball demonstration 
is faster and smoother than Amiga’s or 
the Atari ST’s. 
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There are two versions of what the 
term “GIME” stands for. I like the one 
that says Tandy went out and said they 
needed to be able to do this thing, that 
thing and so on, so please “Gimme a 
chip that'll work.” Officially, though, 
GIME stands for Graphic Interrupt 
Memory Enhancer. Take it either way, 
this li'l’? fellow makes CoCo 3 a super 
special machine. 

I confess to not understanding hard- 
ware like the Tony DiStefanos and 
Marty Goodmans of the world. And I 
am certain that, over the coming 
months, they will be able to tell you a 
great deal of technical stuff about it. But 
suffice it to say now that this new chip 
manages memory through interrupts, 
and speeds everything along its way far 
more swiftly than the old VDG and 
SAM chips (which are not in the CoCo 
3) did. 

For one thing, GIME makes true 
multi-user, multi-tasking possible. It 
allows some of the most sophisticated 
(and easy-to-use) windowing available 
on any computer available today. As an 
example, you could be connected 
through a modem to someone else with 
a CoCo 3 in one window, and have a 
graphics drawing program in a second 
window (windows mean both programs 
are running at the same time and are 
displayed on the screen at the same 
time). The person on the other end 
could be explaining how something 
looks and while he is explaining it, you 
could be drawing it. Then, to be sure 
you got it right, you could send your 
drawing to the telecommunications 
program window and it would appear 
on the other person’s screen. That 
person could make some changes and 
send it back to you, and so on! 
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MOUSE UTILITY 


The last installment of the point-and-pick interface 








By Steve Bjork 


refresh your memory, The 

Qi: is an assembly lan- 

guage program that dis- 

plays and moves a cursor and prints 

upper- and lowercase text on the Hi-Res 

graphics screen. A BASIC program may 

access this interface by 13 user functions 
and the PRINT command. 

Last month we covered the assembly 
language side of the USR function and 
PRINT command, along with the code 
for drawing the cursor (pointer). We 
also looked at how the joystick and 
button information is polled. 

This month we have the second half 
of the source code, bell and clock 
sounds and the Hi-Res screen text 
driver and its character shape data. 

Before getting started I want to re- 
mind you that The Mouse and its source 
code are copyright 1986 by SRB Soft- 





Steve Bjork has been a programmer for 
over 15 years. In his association with 
Datasoft he has authored such pro- 
grams as Zaxxon, Sands of Egypt and 
Mega-Bug. He now handles product 
development for his own company, 
SRB Software, and has produced Stel- 
lar Life Line, Ghana Bwana and PitFall 


Il among others. Steve lives in Simi. 


Valley, California 


CoCo Mouse: 
The Final Chapter 





ware with all rights reserved. It is 
presented in RAINBOW magazine for 
private use only, and can’t be used (all 
or part) in any marketed product with- 
out written consent from SRB Soft- 
ware. 


Makin’ Some Noise! 

The first subroutine of Listing 1 
(MOUSE3/ASM) generates the bell 
sound used in function 7. The bell sound 
is generated by playing a steady tone 
that decreases in volume as it is played 
(see Figure 1). 

So the sound can be heard, the bell 
routine first enables sound to the TV 
and selects the six-bit DAC as the sound 
device by calling SNDON. Next, the 
interrupts are disabled so the timing 
loops are not distorted and the starting 
volume is selected. 

Lines 600 to 1900 generate the enve- 
lope in Figure 1. After bell sound is 
completed, the interrupts are turned 
back on and the TV sound is disabled. 

The click sound does not change in 
volume like the bell, but does become 
lower in pitch as it is played. With click 
being so fast, the interrupts do not need 
to be turned off as before. Lines 4600 
through 5400 flip the bits of the six-bit 
DAC with a longer delay each time to 
generate its wave form. 
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PRINT @ 

The Hi-Res screen text driver has 32 
characters per line, just like the stand- 
ard green text screen. But eight lines 
must be added to make a total of 24 and 
give an extra 256 positions. This does 
present a little problem; the PRINT 


HT iin —_ 
il : ' = i ine 


Figure 1: Bell Sound 


command’s ‘@’ can’t address these new 
lines. So The Mouse intercepts the 
PRINT command to handle the ‘@’ 
function for screen location in NPRINT, 
lines 6300 to 9400 of Listing 1. 
NPRINT jumps to the old PRINT 
command vector (in OLDPRT) if there is 
no ‘@’ after the word PRINT. If there is 
an ‘@’, a 16-bit number subroutine of 
Color BASIC ROM is called to find the 
new location. If this number is larger 
then the window size, then an FC Error 
is generated. With everything OK, the 
cursor is moved to the new location and 
lan nbow 


agazine age 





Leather Disk 







ELECTRONICS 









Accessories not included 


Give your disks a home that’s worthy of them with 
this genuine leather disk box. They won't last long 
at this remarkable saving. It'll hold up to ten 
13.3cm disks in comfort. Closes securely to pre- 
vent any accidents. A stylish accessory. 26-1349 
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Exclusive Offer! 





Stop using your valuable desk space for your computer. Give it a 
permanent home that was specifically designed for it. Ideal for the 
Color Computer, this workstation features a monitor/printer plat- 
. . form and storage shelf for all your software and instruction 
Accessories not included manuals. Measures 66 x 81.2 x 50.2cm. Comes ready for easy 
All items — Limited Stock assembly with all pieces forming simple, yet durable linkages. 26-1354 



















A Functional Printer Stand 






Versatile Computer Table 


Reg 279.95 














*100 


179° 


Small enough to let you set your system up anywhere. 
Large enough to accommodate the Color Computer or 
Tandy 1000. It’s easy to assemble and comes with full in- 
structions. Measures 68.6 x 121.9 x 61cm. 26-1324 
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Accessories not included 


Unlike just any piece of furniture, this piece was speci- 
fically designed for printers. Large enough for wide-bed 
printers. With bottom feed paper slot and storage shelf. 
A must for any computer user. 66 x 68 x 50cm. 26-1355 








Our Lowest Priced Daisy Wheel 
is Now Even Lower 
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Reg 999.00 


Letter perfect printing now for less } - | : 
than $1000. Uses interchangeable O5 — 
100-character print wheels so you — 


can pick the font you want. Prints 
over 200 words per minute at 10 or 


12 cpi. With forward or reverse Reg 229.95 | 

paper-feed. Comes complete with . . 
“Courier 10 Typewriter’ style wheel DWP 220 Tractor Feeder. Give your printer a constant supply of ° 
and carbon printer ribbon so it’s paper the easy way. Matching tractor feed device to this printer 
ready to go. Buy now at this price will make feeding in paper manually a thing of the past. Simple to 
and SAVE! 26-1278 attach or remove whenever you don’t require constant feed. 26-1444 





EACH 


ee Re ce Choose from 381 x 279cm fanfold paper with blue horizontal 
a ee a stripes (900 sheets) 26-9315. 241 x 279cm blank white word- 
processing paper (900 sheets) or 241 x 279cm fanfold paper 
with blue horizontal stripes (1,000 sheets) 26-9315, 26-9316, 26-9317 














WE SERVICE WHAT WE SELL! 


Available From 350 Stores 


landy Australiawide Including 


ELECTRONICS Tandy Computer Centres 
Order On VIATEL #642 


f DINISION OF TANG 350 Stores Independent Tandy Dealers may not be participating in this ad or have every item advertised. 


SUAS IMITED Australia- Prices may also vary at individual Dealer Stores 
INC INNS W Wide 
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04700 





CLICK2 DECB 






GET LONGER EACH TIME 


04800 


10000 


BNE 





04900 LDB 
ae 05000 ORB 
Listing 1: 05100 STB 
05200 INCA 
05300 CPA 
00100 * SOUND AND SCREEN DRIVERS 05400 BLO 
00200 PING BSR SNDON GET SOUND FROM 6 BIT DAC 05500 BRA 
00300 PSHS CC SAVE IRQ FLAGS 05600 
00400 oRcc = _«@ $50 TUEN OFF IRQS 05700 FNERR LDB 
00500 LDA #230 HOW LONG TO DO SOUND 05800 FCB 
00600 PING. BSR PINGS DO A TIME DELAY 05900 SNERR LDB 
00700 06000 JMP 
00800 TFR A,B GET TIME COUNT 06100 
00900 ANDB—s #$F? USE ONLY THE TOP 5 BITS 06200 *MOUSE'S NEW 
01000 ORB #2 SET PRINTER BIT HIGH 06300 NPRINT BEQ 
01100 STB SFF20 SEND IT OUT THE DAC PORT 06400 CMPA 
01200 06500 BNE 
01300 BSR PINGS DO A TIME DELAY 06600 PSHS 
01400 LDB 02 CLEAR ALL BITS BUT PRINTER 06700 LDA 
01500 STB $FF20 ON DAC PORT 06800 ANDA 
01600 DECA MAKE BALL SOUND SMALLER 06900 EORA 
01700 DECA BY 2 07000 PULS 
01800 CMPA #18 IS BELL DONE? 07100 BNE 
01900 BHS PING] NO, THEN LOOP 07200 
02000 PULS cc TURN ON IRQS 07300 ISR 
02100 SNDOFF LDA SFF23 TURN OFF DAC SOUND 07400 PSHS 
02200 ANDA #8 F7 BY RESETTING THE BIT 07500 LEAU 
02300 STA SFF23 07600 CLR 
02400 CLRB MAKE RETURN ZERO 07700 ATL INC 
02500 RTS AND RETURN 07800 SUBB 
02600 07900 SBCA 
02700 SNDON LDA SFF23 TURN ON THE SOUND BY 08000 BCC 
02800 ORA #8 SETTING THE SOUND ON BIT 08100 ADDB 
02900 STA SFF23 08200 LDA 
03000 LDA SFFO1 GET LSB OF JOY/AUDIO 08300 DECA 
03100 ANDA = #SFF-8 PORT AND RESET IT 08400 CMPA 
03200 STA $FFO1 AND PUT IT BACK 08500 BHS 
03300 LDA SFFO3 GET MSB OF JOY/AUDIO 08600 STD 
03400 ANDA — #SFF-8 PORT AND RESET IT TOO 08700 PULS 
03500 STA S$FFO3 AND PUT IT BACK 08800 
03600 RTS NOW EXIT 08900 JSR 
03700 09000 BEQ 
03800 PINGS LDB #180 TIME DELAY USED BY BELL (PING) 09100 CMPA 
03900 PING6 DECB 09200 BNE 
04000 BNE PING6 09300 JSR 
04100 RTS 09400 OPRINT JMP 
04200 09500 
04300 *MAKE A SMALL CLICK SOUND 09600 FHTAB  FDB 
04400 CLICK BSR SNDON TURN SOUND ON TO DAC 09700 FDB 
04500 LDA #10 START TIME DELAY SHORT 09800 FDB 
04600 CLICKl TFR A.B DO A DELAY (USE COUNT) 09900 








CLICK2 


SFF20 GET DAC PORT 
#SFO FLIP TOP 4 BITS 
$FF20 SAVE SET PORT 
MAKE DELAY LONGER 
#76 ALL DONE? 
CLICK1 NO, LOOP BACK 
SNDOFF ELSE SOUND OFF AND EXIT 
#4e2 GO HERE FOR ?FN ERROR 
$8c 
#2 GO HERE FOR ?SN ERROR 
$AC46 JUMP TO ERROR (OF BASIC) 


PRINT COMMAND 


OPRINT SKIP IF NO PRINT DATA 
#64 IS THE FIRST CHAR. A "@"? 
OPRINT 
A 
$FF22 GET GRAPHICS MODE 
WSEO IS SCREEN A PMODE 3 TO 4 
#SEO 
A 
OPRINT NO, THEN USE OLD PRINT COMMAND 
$B3E4 GET VAL FOR THE @ POSITION 
U SAVE U, NEED FOR VARIABLE BLOCK 
DATA, PCR GET VARIABLE POINTER 
COUNT ,U CLEAR LINE COUNT 
COUNT ,U ADD ONE TO LINE COUNT 
WDXLEN ,U SUB ONE LINE WIDTH 
#0 (DO 16 BIT SUB) 
AT1 LOOP TILL NEG 
WDXLEN , J ALWAYS ONE TOO MANY 
COUNT, U GET LINE COUNT 
ALWAYS ONE TOO MANY 
WDYLEN ,U IS THE LINE OUT OF THE WINDOW 
FPNERR FM ERROR IF OUT OF RANGE 
YCPos ,U SAVE THE LINE & COLUMN POSITION 
it} RESTORE U REG. 
$A5 GET NEXT CHAR. 
OPRINT END IF END OF PRINT DATA 
#$2C IS THE CHAR. A ","? 
SNERR NO, THEN ?7SN ERROR 
SOF SET FLAGS FOR CHARACTER 


{OLDPRT+DATA, PCR] 


CHR1-PMTAB 
PMODE1-PMTAB 
PMODE2 - PMTAB 


WMODE1 - PMTAB 


TABLE USED FOR PMODE TYPE 


Pattern 


, eee 


Binary 

00011100 
00100010 
00100000 
00011100 
00000010 
00100010 
00011100 
00000000 


Hex 
$1C 
$22 
$20 
$IC 
$02 
$22 
$IC 
$00 


Decimal 


Figure 2: Dot Format for ‘S’ 


the old PRINT command handles the 
rest of the line. 


Outgoing Intercepters 

All characters that would normally 
go to the text screen are intercepted by 
The Mouse. This is done by redirecting 
the standard output path through 
SPRINT at Line 10500. This routine 
calls CHR (Hi-Res text driver) if a Hi- 
Res graphics screen is selected. If a Lo- 
Res graphics or text screen is displayed 
at the time, then the old standard output 
path is used. 

The routine that prints a character to 
the Hi-Res screen, CHR, must first 
decide what mode it is in. These modes 
are Standard, Set Cursor Position and 
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Set Window. Standard prints the char- 
acter, does a control code or sets up the 
other two modes. Set Cursor Position 
mode takes the next two characters (X 
and Y position) and moves the cursor 
(lines 13600 through 15100). The Set 
Window mode takes the next four 


-characters and sets up a new scroll- 


protected window (lines 10400 through 
15400 of Listing 2). 

Standard mode first tests if the char- 
acter is a control code, 0 to 13, with 
CHRTAB holding the offset vector for 
these routines. Some of the routines are 
Line Feed, Clear Screen, Carriage 
Return, Set Window and Set Cursor 
Position. 

Next is a test for displayable range (32 
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to 127). If it is in range, then the char- 
acter’s shape is selected out of 
CHRDAT shape data. The Shape Data 
format is one byte (eight dots) wide and 
eight bytes (lines) high. 

MOUSE4/ASM (Listing 2) is the 
CHRDAT shape data table for all 96 
displayable characters. Each character 
shape consists of one byte (eight dots) 
wide by eight bytes (scan lines) high. If 
the bit is a zero, then a black dot is 
placed on the screen. And of course, if 
the bit is a one, then a white dot is 
displayed. Dot format for the letter “S” 
is shown in Figure 2. 

Each line of the CHRDAT shape data 
table has eight bytes (four word length) 
per line. Some assemblers do not allow 
for more then one expression per line. 
If this is the case with your assembler 
then all 96 FDB lines must be replaced 
by four FDB lines with one expression 
each. 

That’s all the source code. If you have 
any questions about The Mouse or its 
source code just drop me aline, or better 
yet, look for me (6809er) at RAINBOW’Ss 
Color Computer SIG on Delphi. 

(You may contact Mr. Bjork at 2529 
Ellington Court, Simi Valley, CA 
93063. Please enclose an SASE when 
writing.) OQ) 


10100 FDB 
10200 FDB 
10300 FDB 
10400 

10500 SPRINT PSHS B 
10600 LDB $FF22 
10700 EORB #SEO 
10800 ANDB #SEO 


WHODE2 - PMTAB 
WHODE3 - PMTAB 
WMODE4 - PMTAB 


11000 
11100 ORB $6F 


11300 
11400 PULS B 

11500 BEQ SPRNT1 

11600 [OLDIO+DATA, PCR] 
11700 
11800 
11900 
12000 PSHS 
12100 LEAU 
12200 LDB 
12300 LEAX 
12400 LSLB 
12500 LDD 
12600 LEAX 
12700 LDA 
12800 JSR 
12900 LDB 
13000 ORB 
13100 LDA 
13200 STD 
13300 PULS 
13400 

13500 *SET TEXT CURTSOR Y POSITION 
13600 PMODE2 CMPA  WDYLEN,U 
13700 BLO PMODEA 

13800 LDA WDYLEN,U 
13900 DECA 
14000 STA 
14100 CLR 
14200 RTS 
14300 

14400 *GET X POSITION 
14500 PMODEL CMPA 
14600 BLO 
14700 LDA 
14800 DECA 
14900 PMODEB STA 
15000 INC 


15100 RTS 
15200 


LEAS 2,8 


U,Y,X,D 
DATA, PCR 
PMODE ,U 


Pc,U,Y,X,D 


ycros ,U 
PMODE,U 


WDXLEN ,U 
PMODEB 
WDXLEN ,U 


xcros ,U 
PMODE ,U 
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ANER HAS A DISPOS- ABLE FILTER 
ELEMENT THAT SHOULD BE CHANGED 
WHEN IT BECOMES BLOCKED WIT 
H DIRT. IF AIR CAN NOT GET TO 
THE CARBURETOR WE WILL FAIL T 

O GET IGNITION. ": GOTOQ190 

174 CLS: PRINT@4,"*xk OIL PRESSURE 
LOW *k": PRINT@65,"THE RED WARN! 
NG LIGHT WILL COME ON WHEN OIL P 
RESSURE IS LOW. THIS LIGHT W! 
LL COME ON MOMEN- TARILY WHEN S 
TARTING ENGINE.” : GOTQ190 

176 'BATTERY DEAD 

178 GOSUB98: GOSUB108: IF INKEY$=" 

C" THENL22ELSE178 

180 'AIR INTAKE BLOCKED 

182 IF INKEY$<>"S"THEN182 ELSEGO 

SUB90: GOSUB94: PAINT (80, 144),1,3 
184 'NO GAS 

186 GOSUB98: GOSUB108: FORY=1TO3: P 

LAY" T3QOAPCDEEDCBA” : GOSUB28: NEXTY 
: IF INKEY$="C"THENI22 ELSE186 
188 'CORRECT ANSWER OR NOT 

190 IF A=D*2 THENPRINT@422,"* CO 

RRECT ANSWER *": R=R+1: D=0: SOUND1 

40,11: SOUND180, 11: SOUND176, 4: SOU 

ND165, 4: SOUND154, 4: SOUND200, 12:8 

OUND180, 17: GOSUB46: IF R=5 THEN20 

8 ELSEDSO 

192 PRINT@425," WRONG ANSWER”: SOU 

ND1, 4: W=W+1: GOSUB46 

194 SCREEN1,0:ON D GOTO186, 178, 8 
,8, 186 

196 CLSO: PRINTSTRINGS$(160,191);8 


SAVE IT'S DATA, I NEED TO USE IT 
GET SCREEN MODE 

COMPLEMENT HI-RES BITS 

ONLY USE THOSE BITS 

10900 * IF THE SCREEN IS IN THE HI-RES (6K) MODE THEN B=0 


GET I/O PATH NUMBER 
11200 * IF THE I/O PATH IS THE SCREEN (ZERO) THEN B STILL WILL BE ZERO 


GET B OLD DATA 
SKIP IF FOR HI-RES SCREEN 


REMOVE PATCH-CALL ADDRESS 


SAVE ALL REGS. 

GET ADDRESS OF VARIABLES 

GET PRINT MODE 

GET PRINT MODE OFFSET TABLE 
MAKE PRINT MODE *2 FOR 16 OFFSET 
GET PRINT MODE'S 16 BIT OFFSET 
MAKE X POINT THE SUBR. 

GET CHARACTER TO PRINT 

CALL IT 

GET PRINT CURSOR X POSITION 
MAKE IT BOTTOM LINE 


PUT IT IN BASIC’S CURSOR POSITION 
RESTORE REGS AND EXIT 


IS Y POSITION BIGGER THEN THE 
WINDOW? NO, USE IT! 
ELSE USE THE MAX POSITION 


15300 CHRTAB FDB 
15400 FDB 
15500 FDB 
15600 FDB 
15700 FDB 
15800 FDB 
15900 FDB 
16000 FDB 
16100 FDB 
16200 FDB 
16300 FDB 
16400 FDB 
16500 FDB 
16600 FDB 
16700 

16800 CHR1 CMPA 
16900 BHI 
17000 LSLA 
17100 LEAX 
17200 LDD 
17300 

17400 

17500 CHR20 

17600 

17700 

17800 

17900 

18000 

18100 

18200 

18300 

18400 

18500 

18600 

18700 CHR21 

18800 

18900 

19000 

19100 

19200 

19300 

19400 

19500 

19600 

19700 CHR22 

19800 

19900 

20000 

20100 

20200 

20300 

20400 

20500 CHR29 


ELSE USE OLD I/O PATH CALL 


STORE IT 
RESET PMODE TO NORMAL 
AND EXIT 


IS THE X POSITION TOO BIG? 
NO, USE IT! 
ELSE USE THE MAK X POSITION 


STORE IT 
MOVE TO NEXT PRINT MODE 


AND EXIT 


TRINGS (160, 207) ; STRINGS (160, 175) 
;: PRINT@71,"4 CYLINDER ENGINE”; : 

PRINT@230, "EDUCATIONAL PROGRAM"; 
: PRINT@391," MICHAEL B KROMEKE”; 
198 A=At] 

200 M=PRND(5): FORB=1TOS 

202 IF M=M(B)THEN2Z00 

204 NEXTB: MCA)=M: IF ACS THEN198 

296 GOSUB218: RETURN 

208 D=5/(5+W): CLS: PRINTO72, " NUMB 

ER CCRRECT 5": PRINT@136, "NUMBER 
WRONG’ W: PRINT@200,"SCORE ="INT(1 
OO0#D)"%": GOSUB218:1F D<.5 THEN P 

RINT@264," BEGINNER" 

210 IF D>.49 AND D<1 THENPRINT@2 

62,"SHADE TREE MECHANIC” 

212 IF D=1 THENPRINT@264, "MASTER 
MECHANIC” 

214 GOSUB218: PRINT@328," PLAY AGA 
IN Y/N"; : INPUTZ$: 1FZ$="N"THEN EN 
D ELSE RUN 

216 'JOPLIN'S ENTERTAINER 

218 PLAY" V30TZ202L8DD+EL403CO2L8E 

O3L4CO2L8EO3CL2CL8CCDD+ECDEEO2BO 
3DL2. CL4": RETURN 

220 CLS4: PRINT@192," OIL LEAKED 
QUT OF ENGINE AND IT FROZE UP. Y 

OV LOST YOUR ENGINE AND THE GAM 
E. SORRY !!!" 


ctoper 


NUL-CHRTAB 


CONTROL COD. VECTORS 


SETPOS-CHRTAB 
SVIDEO-CHRTAB 
IVIDEO-CHRTAB 
SETWIN-CHRTAB 
LEFT-CHRTAB 
RIGHT-CHRTAB 
PING -CHRTAB 
BACKSP -CHRTAB 
TAB-CHRTAB 

LF -CHRTAB 
UPLINE -CHRTAB 
CLS - CHRTAB 
CR-CHRTAB 


#13 
CHR20 


IS THE CHARACTER A CONTROL CODE? 
SKIP IF NOT 
ELSE JUMP TO IT VECTOR 


CHRTAB, PCR 


xcPos ,0 
ycros ,U 
SCROLL 


>CHRDAT, PCR 


#8 


XcPros,U 


ust 


IS IT A PRINTABLE CODE? 
NO, THEN SKIP TO EXIT 


PUT MOUSE CURSOR ON HOLD 

GET X-POSITION ON SCREEN 

PAST RIGHT SIDE? 

NO, JUST PRINT IT 

ELSE BACK TO LEFT SIDE 

AND MOVE DOWN LINE 

IF NEEDS TO SCROLL, THEN SCROLL! 


GET CHR DATA TABLE 
INDEX TO THE CHAR. DATA 


GET WINDOW START POSITION 
GET TEXT CURSOR POSITION 
ADD SCREEN START IN MEMORY 
AND POINT X TO IT 

NUMBER BYTES PER CHAR. 
GET DATA BYTE 

INVERT IF FLAG IS ON 

PUT IT ON THE SCREEN 

NEXT LINE ON SCREEN 

ALL BYTES DONE??? 

LOOP IF NOT 


NEXT POSITION ON SCREEN 
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Colo 3 has, under O8-9 Level 
II, a user interface much like 
the Macintosh but far faster and 
in full color. For the CoCo 3, 
OS-9 has become virtually 
invisible ta the user who wants 
it that way - in other words, 
you can deal with the 
appications and programs you 
want, and pretty much ignore the 
operating system unless you want 
to use it. 

In short, CoCo 3 is a new 
generation of home and small 
business computer - fully as 
revolutionary as the original 
Color Computer was five years 
ago. Its great advantage is that 
it already has one of the 
largest bases of software (and 
hardware for that matter) of any 
machine on the market, plus a 
raft of OS-9 Level II software 
which has been around for _ some 
time. 

Even at $6C0O (US), CoCo 3 
would be the best single home 
and business buy in the world of 


computers. At $219.95 (US), it 
is not only a_- stupendous 
machine, but an immense bargain 


as well. With the Color Computer 
3, Tandy has moved to_- the 
cutting edge of technology and 
made the technology affordable 
for virtually everyone. 

1an n 


Ow agazine age 


PART 2 OF SCREEN DRIVER 


*THIS ONE DOES A RETURN ON TEXT SCREEN 


Listing 2: 
00100 *MOUSES/ASM 
00200 
00300 
00400 CR LDB 
00500 SUBB 
00600 CRI DECB 
00700 BMI 
00800 PSHS 
00900 LDA 
01000 LBSB 
01100 PULS 
01200 BRA 
01300 
01400 CR2 CLR 
01500 
01600 *DO A LINE FEED 
01700 LF INC 
01800 SCROLL PSHS 
01900 LDB 
02000 CMPB 
02100 BLO 
02200 DEC 
02300 
02400 BSR 
02500 LDA 
02600 STA 
02700 LDA 
02800 DECA 
02900 BEQ 
03000 
03100 LDA 
03200 ADDA 
03300 LDB 
03400 TFR 
03500 LDA 
03600 DECA 
03700 LSLA 
03800 LSLA 
03900 LSLA 
04000 SCROLL] PSHS 
04100 LDB 
04200 LSRB 
04300 BCC 
04400 LDA 
04500 STA 
04600 SCROLL2 STB 
04700 BEQ 
04800 SCROLL} LDD 
04900 STD 
05000 DEC 
05100 BNE 
05200 SCROLL4 PULS 
05300 LEAX 
05400 DECA 
05500 BNE 
05600 
05700 SCROLLS LDB 
05800 LDA 
05900 SCROLL6 PSHS 
06000 LDB 
06100 SCROLL? STA 
06200 DECB 
06300 BNE 
06400 PULS 
06500 LEAX 
06600 DECB 
06700 BNE 
06800 LDA 
06900 STA 
07000 SCROLLS PULS 
07100 
07200 HOLDIT PSHS 
07300 LDA 
07400 STA 
07500 LBSR 
07600 PULS 
07700 
07800 CLS BSR 
07900 LDA 
08000 STA 
08100 LDD 
08200 ADDA 
08300 TFR 
08400 LDA 
08500 LDB 
08600 LSLB 
08700 LSLB 
08800 LSLB 
08900 CLS1 PSHS 
09000 LDB 
09100 CLS2 STA 
09200 DECB 
09300 BNE 
09400 PULS 
09500 LEAX 
09600 DECB 
09700 BNE 
09800 CLR 
09900 CLR 
10000 LDA 
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WDXLEN ,U 
xXcpos ,U 


CR2 

B 

#32 
CHR20 
B 

CR1L 


XCPOS ,U 


rcPros ,U 
A 
YCPos ,U 
WDYLEN ,U 
SCROLL9I 
YcPos ,U 


HOLDIT 
#15 

HOLD ,U 
WDYLEN ,U 


SCROLLS 


WDYPOS ,U 
SSTART 
WDXPOS ,U 
Dx 
WDYLEN ,U 


X,A 
WDXLEN , U 


SCROLL2 
256 ,X 
»at 
COUNT ,U 
SCROLLS 
256,X 
»Xt+ 
COUNT ,U 
SCROLL3 
X,A 
32,X 


SCROLL1 


#8 
INVERT ,U 
x,B 
WDXLEN ,U 
,X+ 


SCROLL? 
x,B 
32,X 


SCROLL6 
#2 

HOLD ,U 
PC,A 


D,Y,U,x 
#2 

HOLD ,U 
CUROFF 


PC,U,Y,X,D 


HOLDIT 
#10 

HOLD ,U 
WDYPOS ,U 
SSTART 
DX 
INVERT ,U 
WDYLEN,U 


B,X 
WDXLEN ,U 
xt 


CLS2 
x,B 
32,X 


cLS1 
rcros ,U 
xcros ,U 
#2 
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GET LINE LENGTH 

GET BYTE LEFT ON LINE 
ANY BYTES LEFT ON LINE? 
SKIP IF NOT 

SAVE COUNTER 

GET SPACE * * 

PRINT IT ON SCREEN 

GET COUNTER 

LOOP TILL END OF LINE 


PUT TEXT CURSOR AT START OF LINE 


MOVE DOWN ONE LINE 

SAVE PRINTING CHAR. 

GET LINE POSITION 

IS THIS LINE OFF SCREEN? 
NO, SKIP AND EXIT 

ELSE MOVE UP A LINE 


TURN OFF CURSOR FOR PRINTING 


MAKE THE HOLD A LITTLE LONGER 
GET NUMBER LINE IN WINDOW 
DON'T SCROLL THE LAST LINE 
SKIP ONLY ONE LINE 


GET TEXT WINDOW LINE POSITION 
ADD THE SCREEN START POSITION 
GET WINDOW C POSITION 

AND MAKE X POINT TO IT 

GET NUMBER OF LINES IN WINDOW 
DON'T SCROLL THE LAST ONE 

MUL BY 8 SCAN LINES 


SAVE SCAN LINE COUNT & POINTER 
GET WINDOW X LENGTH 

DIVIDE BY 2 

SKIP IF EVEN 

MOVE ONE BYTE IF ODD 


SET BYTE COUNTER 
SKIP IF ONLY ONE BYTE TO MOVE 
ELSE MOVE TWO BYTES AT ONCE 


LOOP TILL ALL BYTES ARE DONE 


RESET BACK TO START OF LINE 
MOVE TO NEXT SCAN LINE 

ALL LINE MOVED? 

LOOP IF NOT 


LINES TO BE BLANKED 

GET BACKROUND (BLACK OR WHITE) 
SAVE LINE START AND COUNTER 
GET NUMBER OF BYTES PER LINE 
PUT DOWN BACKROUND 

ALL DONE WITH THIS LINE? 

NO, THEN LOOP 

GET COUNT & START OF LINE 
MOVE TO NEXT LINE 

ALL LINES DONE 

LOOP IF NOT 

RESET HOLD 


AND EXIT 


SAVE ALL REGS 
DELAY CURSOR FOR 2 IRQS 


TURN OFF CURSOR 
RESTORE AND EXIT 


PUT CURSOR ON HOLD 
PIT IT ON HOLD A LITTLE LONGER 


GET WINDOW POSITION 

ADD START OF SCREEN MEMORY 
MAKE X THE POINTER TO SCREEN 
GET BACKROUND COLOR 

GET NUMBER OF LINES 

8 LINES PER TEXT LINE 


SAVE LINE COUNT & POINTER 
GET NUMBER OF BYTES PER LINE 
PUT BACKROUND ON SCREEN 

ARE ALL BYTES DONE ON LINE 
NO, THEN LOOP BACK 

GET LINE COUNTER & START OF LINE 
MOVE TO NEXT SCAN LINE 

ALL SCANS DONE? 

NO, THEN LOOP 

PUT TEXT CURSOR AT 

TOP OF WINDOW 

RESET HOLD TO STANDARD 


10100 
10200 
10300 
10400 
10500 
10600 
10700 
10800 
10900 
11000 
11100 
11200 
11300 
11400 
11500 
11600 
11700 
11800 
11900 
12000 
12100 
12200 
12300 
12400 
12500 
12600 
12700 
12800 
12900 
13000 
13100 
13200 
13300 
13400 
13500 
13600 
13700 
13800 
13900 
14000 
14100 
14200 
14300 
14400 
14500 
14600 
14700 
14800 
14900 
15000 
15100 
15200 
15300 
15400 
15500 
15600 
15700 
15800 
15900 
16000 
16100 
16200 
16300 
16400 
16500 
16600 
16700 
16800 
16900 
17000 
17100 
17200 
17300 
17400 
17500 
17600 
17700 
17800 
17900 
18000 
18100 
18200 
18300 
18400 
18500 
18600 
18700 
18800 
18900 
19000 
19100 
19200 
19300 
19400 
19500 
19600 
19700 
19800 
19900 
20000 
20100 
20200 
20300 
20400 
20500 


SVIDEO 
NUL 


SETPOS 


SETWIN 


WMODE1 


WMODE2 


WERROR 


WHODE3 


WMODE4 


IVIDEO 


WTHIS IS A BACK 


BACKSP 


BACKS1 


LEFT 


LEFTL 


RIGHT 


RIGHTL 


UPLINE 


UPLIN1 


TAB 


TAB1 


STA 
RTS 


CLR 
RTS 


LDA 
STA 
RTS 


LDA 
STA 
RTS 


CMPA 
BHS 
STA 
NEGA 
ADDA 
STA 
CLR 
CLR 
INC 
RTS 


CMPA 
BHS 
STA 
NEGA 
ADDA 
STA 
INC 
RTS 


CLR 
LBRA 


BEQ 
CMPA 
BHT 
STA 
INC 
RTS 


BEQ 
CMPA 
BHI 
STA 
CLR 
RTS 


LDA 
STA 
RTS 


LDD 
DECB 
BPL 
LDB 
DECB 
DECA 
BPL 
INCA 
CLRB 
STD 
LDA 
LBSR 
DEC 
RTS 


LDA 
DECA 
BPL 
LDA 
DECA 
STA 
RTS 


LDA 
INCA 
CMPA 
BLO 
CLRA 
STA 
RTS 


DEC 
BPL 
LDA 
DECA 
STA 
RTS 


LDB 
ANDB 
NEGB 
ADDB 
LDA 
PSHS 
LBSR 
PULS 
DECB 
BNE 
RTS 


HOLD ,U 


INVERT ,U 


#1 
PMODE ,U 


#3 
PMODE ,U 


#31 
WERROR 
WDXPOS ,U 


#32 
WDXLEN ,U 
YCPOS ,U 
XCPOS ,U 
PMODE ,U 


#23 
WERROR 
WDYPOS ,U 


#24 
WDYLEN ,U 
PMODE ,U 


PMODE ,U 
FNERR 


WERROR 
WDXLEN , 0 
WERROR 
WDXLEN ,U 
PMODE ,U 


WERROR 
WDYLEN ,U 
WERROR 
WDYLEN ,U 
PMODE ,U 


#255 
INVERT ,U 


SPACE CODE ($08) 


YCcPos ,U 
BACKS1 
WDXLEN , U 


BACKS1 


ycros ,U 
#32 
CHR20 
xXCPos ,U 
XCPOS ,U 


LEFT1 
WDXLEN , U 


xcpros ,U 


XcPpos ,U 


WDXLEN , U 
RIGHT1 


xcros ,U 
ycPros ,U 
UPLIN1 
WDYLEN,U 
YCPOS ,U 
xcpos ,U 


e7 


#8 


AND EXIT 


MAKE WHITE ON BLACK 


START GET CURSOR POSITION 


START GET WINDOW SIZE & POSITION 


IS WINDOW X START POS <31 
IF NOT THAT ERROR 


GET MAX WINDOW X LEG FOR THAT 
START PSOITION 

AND USE IT FOR NOW 

HOME TEXT CURSOR TO TOP 

LEFT OF WINDOW 

MOVE TO NEXT PRINT MODE 


IS WINDOW Y START POS <23 
IF NOT THEN ERROR 


GET MAX WINDOW X LEN FOR THAT 
STARTING POSITION 


MOVE TO NEXT PRINT MODE 


RESET PRINT MODE 
AND GIVE A ?FN ERROR 


ERROR IF 0 BYTES PER LINE 
IS THIS WINDOW TOO BIG? 
?7FN ERROR IF SO 

ELSE SET LINE LENGTH 

MOVE TO NE XT PRINT MODE 


ERROR IF LENGTH IS ZERO 
IS THE SIZE TOO BIG? 

FN ERROR IF SO 

ELSE SET IT 

RESET PRINT MODE 

AND EXIT 


SET BLACK ON WHITE VIDEO 


GET TEXT CURSOR POSITION 

BACK UP ONE 

USE IT IF STILL ON THE SAME LINE 
ELSE MOVE CURSOR TO END 

OF LINE 

AND MOVE UP ONE LINE 

USE IT IF NOT THE TOP OF WINDOW 
ELSE BACK TOP TOP LINE 

AND START OF THE LINE 

STORE NEW TEXT CURSOR POSITION 
CLEAR (BLANK) THE NEW TEXT 
CURSOR POSITION 

MOVE BACK TO THAT PLACE 

AND EXIT 


GET TEXT CURSOR'S X POSITION 
MOVE BACK ONE 

IF STILL ONE LINE? THEN USE IT 
ELSE MAKE IT THE MAX RIGHT 
POSITION ON LINE 

AND STORE IT 

ALL DONE AND EXIT 


GET TEXT CURSOR'S X POSITION 
MOVE TO RIGHT 

GONE TOO FAR? 

NO, THEN USE IT (SKIP) 

ELSE MOVE TO FAR LEFT 

AND STORE IT 

ALL DOWN, EXIT 


MOVE TEXT CURSOR UP ONE LINE 


MOVE OFF OF TOP OF WINDOW?, NO SKIP 


SET TO BOTTOM OF WINDOW 


GET TEXT CURSOR POSITION 


GET OFFSET FROM TAB STOP (EVERY 8) 


GET NUMBER TO NEXT NEXT ONE 


GET A SPACE * * 
SAVE BOTH 

PRINT THAT SPACE 
GET BOTH 

AT NEXT TAP STOP? 
NO, THEN LOOP 


a 
TUR F THE SCREW 


Let’s Take a Look 
at the CoCo 2 B 


By Tony DiStefano 


Rainbow Contributing Editor 





his week I had the honor of 
| repairing an old ‘D’ board Color 
Computer belonging to “K1ISSa- 
ble OS-9” author Dale L. Puckett. 
Although there are a lot of old CoCos 
still out there, you can’t get any more 
of them. Today, Radio Shack is ped- 
dling a CoCo with the letter ‘B’ in the 
catalog number. I don’t know what the 
‘B’ stands for, but there are a few 
changes inside. I bought one at the Palo 
Alto RAINBOWfest. What I want todo 
here is explain some of the changes 
Radio Shack has made. 

The first thing I noticed when I 
opened the box is that it says Tandy on 
the computer and not Radio Shack. It 
also says Color Computer and not 
CoCo 2. This is the smallest PCB 
(Printed Circuit Board) I have seen for 
a CoCo. Small is good in many ways. 
First, it costs less to produce. It also has 
the least parts count of all the CoCos 
ever made. Not only is this good for 
production costs, it’s also good for 
users. The lower the parts count in a 
computer, the less likely a breakdown. 
Then there is the question of heat; all 
electronic parts, whether digital or 


analog, dissipate heat. How many times 


Tony DiStefano is well-known as an 
early specialist in computer hardware 
projects. He lives in Laval Ouest, Que- 
bec. 


have you heard that the computer 
crashes when it is too hot? Fewer parts 
mean less heat. 

This computer does not have any 
regulated 12 volts, the same as the other 
CoCo 2s. There is no negative voltage 
available except on the SALT chip, 
which buffers and converts the RS-232 
signals. In theory, RS-232 specifies that 
the signal be +/-12 volts. This new 
CoCo 2 (and all other CoCo 2s) have 
only +/-5 volts. While this will work 
with most RS-232 devices, check the 
specifications to be sure. Again, as with 
the other CoCo 2s, there are about 12 
volts unregulated at the power diodes, 
which can be used for devices needing 
the voltage. The diodes are numbered 
D10 and DI1. Remember, the side with 
the white band is the positive side. 

The next interesting part in this CoCo 
2 B is a PIA (Peripheral Interface 
Adapter). The first CoCos had two 
PIAs of the same kind. They were both 
MC682Is by Motorola. The next stage 
of the CoCo had one MC6821 and one 
MC6822. This 6822 is called an IIA 
(Industrial Interface Adapter). There is 
just a small difference between the two. 
Now the second PIA in the CoCo 2 B 
is no longer an MC6822, but an 
SC67331P. It is a Motorola part, and 
compatible with the MC6822. The 
difference is in the impedance matching 
between the keyboard and the PIA — 





custom made for Tandy, no doubt. If 
you happen to destroy this part, a 
regular MC6822 will work. The key- 
board matrix is the same. 

As with the CoCo 2 A, there are six 
jumpers, JI to J6. One of the jumpers 
is used to detect the presence of 64K 
memory RAM. The other five jumpers 
are labeled 64K/128K. A lot of people 
think that this means you can have 
128K of RAM. This is not true. Look 
again; there is only one place for ROM. 
Before, there were two sockets, one for 
the BASIC ROM and the other for the 
Extended BASIC ROM, each ROM 
being 8K long. A ROM’s capacity ts 
usually expressed in bits. In the CoCo, 
the data bus is eight bits wide. Therefore 
an 8K ROM has BK times eight bits, 
giving you 64K bits. Starting to get the 
picture? Since there is only one place on 
the PCB for BASIC and Extended BASIC, 
anew chip with both 8K ROMs (or 64K 
bits) gives you 16K or, like the label 
says, 128K. 

If you bought the computer without 
Extended BASIC, you got a socket and 
an 8K ROM in a 28-pin package. The 
jumpers are set to the 64K position. If 
you bought an Extended BASIC ma- 
chine, you got a soldered-in 16K ROM 
with the jumpers set to the 128K side. 
In both cases you got a new version of 
BASIC, Version 1.3. If you have Ex- 
tended BASIC, then you only see the 








Extended BASIC Version, |.1. To see the 
BASIC version type in EXEC 41175. 

To take this further, the two ROMs 
Tandy uses, 8K and 16K, are pin-for-pin 
compatible with two EPROM counter- 
parts. The 28-pin BASIC ROM is com- 
patible with the Intel 2764 EPROM. 
The 28-pin Extended BASIC ROM is 
compatible with the Intel 27128 
EPROM. Now you can see where the 
64K /128K numbers come from. If you 
have an EPROM programmer, modify 
these ROMs to suit yourself and plug 
them right in. Of course, if the ROM is 
soldered in, you will have to desolder it 
and put in a socket. Don’t forget to 
change the jumpers to the right place. 
More on this later. 

The RAM portion is quite impres- 
sive. There are three ways to add 64K 
to this CoCo 2 B. If you have 16K of 
RAM on the computer, chances are the 
chips Tandy used are two 4416 RAM 
chips. These chips are 16K by four bits 
each. Since the CoCo needs eight bits, 
there are only two of these chips. These 
chips are in the two 18-pin sockets 
between the two white connectors. The 
first way to upgrade this 16K computer 
is to change these two chips for the 64K 
counter part. The number to this is 
4464. There are a lot of different 
numbers that are compatible with this 
chip. Just ask for a 4464, a 64K by four 
DRAM or an equivalent. 

With the computer turned off, re- 
move the two memory chips and install 
the two new ones. On the left side, there 
is a white box marked J6, jumper 6. You 
must solder a jumper across the two 
pins inside this box. This tells the 
software that there are 64K memory 
chips installed. That’s all there is to it. 

The next way to upgrade is using the 
two white connectors. These connectors 
consist of all the lines necessary to 
connect 64K of memory. A small PCB 
will be necessary. The pinouts to the 
connectors are in Figure I. 

There are two reasons why I’m not 
going into details on how to construct 
this piggyback board. The first is that 
it is available, fully assembled and 
tested, from CRC Inc. (514) 383-5293 
for a modest price, and the other reason 
is that there is a third method of up- 
grading this CoCo 2 B. 

If you have some 64K chips lying 
around gathering dust, you'll like the 
third way to upgrade. See all those holes 
filled with solder? Do you see the eight 
empty IC names soldermasked on the 
PCB? These eight blank areas are made 
for 64K memory chips. The regular run 


CN3 
Function 


COIAWRWN- 


CN4 


Pin Function 
l GND 
2 A7 
3 A3 
4 A2 
5 Al 
6 AO 
7 DQ6 
8 DQ5 
9 DQ7 

10 DQ4 

11 CAS 

12 GND 


Figure I 





of the mill 4164s. All you have to do is 
add eight sockets and plug them right 
in. There is a small catch: The holes for 
these ICs are filled with solder. You 
must first empty the holes of their 
solder. You can use a device such as 
Radio Shack’s desoldering pump (less 
than $20). Just heat up the hole to be 
cleaned with a hot soldering iron. Then 
bring the desoldering pump to the hole. 
Remove the iron, press the pump to the 
hole and press the pump button. Go 
through all the holes of each pin. It 
would be wise to solder in sockets, not 
the chips directly. On some boards, the 
eight decoupling capacitors are also 
missing. Insert eight .1 UF capacitors. 
As with any upgrade to 64K, don’t 
forget to jumper the connections at J6. 
That’s all there is to it. 

There are a few more changes in the 
CoCo 2 B. Until now, all CoCos used 
the Motorola MC6847 as a display 
processor. This is the chip that gives the 
text on the screen and all of the graphics 
modes. Text on the screen has been 
green with black letters. When typing in 
lowercase letters, they would appear as 
inversed blocks of black with green 
letters. The new chip that Tandy uses on 
this CoCo 2 B is slightly different. It is 
an MC6847TI. (This chip might also 
have the part #XC80652P.) This chip 1s 
different. It has built-in real lowercase 
characters and you can also get rid of 
that border in certain cases. This is a 
real nifty improvement to the CoCo’s 
display. The only problem with this is 
that Extended BASIC will not let you use 
these added features. Next month, I'll 
get my soldering iron out and add a few 
switches to change the default values. 

The last change the good people at 
Tandy made was in the SAM (Synchro- 
nous Address Multiplexer). With all 


these changes to memory, video and 
circuitry, anew SAM chip is needed. It 
is the SN74LS785. A Motorola part 
that is upward compatible with the old 
SN74LS783 or the MC6883. 

Back to the 28-pin ROM. Earlier, | 
mentioned that the ROM Tandy used is 
pin-for-pin compatible with an 
EPROM. A long time ago, a reader 
asked if there was a way to add a DOS 
chip inside the CoCo. Now there is. 
There are many ways to do this. Differ- 
ent people like to solder things together 
in different ways. I like the fastest and 
easiest way. Some people like to make 
it neat. The chip you must use is either 
a 2764 or a 27128. All of the address 
lines, data lines and power lines are the 
same. The only line that is different will 
be the chip select line. We'll get that line 
from another chip. The chip enable line 
on an EPROM is pins 20 and 22. These 
are the pins that must connect to the 
extra enable. The thing to do is connect 
all the pins except the two enable pins. 
Here is where some people differ. I used 
a 28-pin socket and soldered all the pins 
(except 20 and 22) to the 28-pin ROM. 
I bent pins 20 and 22 up and soldered 
them together, running a wire to Pin 12 
of the 74LS138. That’s the easy way. 

Now, plug in the new EPROM and 
the cartridge area socket will be inside 
the CoCo. Some people don’t like to 
solder directly to a ROM. Use a wire 
wrap socket and solder a second socket 
to the legs about halfway down. Cut 
pins 20 and 22 from the top socket. 
Solder these two pins to the 74LS138 
mentioned above. Plug the ROM into 
the lower socket and the EPROM into 
the upper socket. The same results 
happen, but it is neater. No soldered 
ROM, but it is also a little more trouble. 
Take your pick. i ~ 
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3-D GRAPHICS 





Graph-O-Matic 


By Jeff Harper 


A fast way to plot 3-D functions using the CoCo 





| program, 3DFNCPLT, 

M is a three-dimensional 

function plot which 

quickly graphs any function in a 3-D 
Cartesian coordinate system. 

To achieve 3-D graphing, the pro- 
gram plots the function over the range 
of ‘Y° coordinates (from smallest to 
largest) for each *X’ coordinate. It then 
graphs the function over the range of ‘X’ 
coordinates (again from smallest to 
largest) over the range of ‘Y’ coordi- 
nates. This produces a stunning graph 
of the function which resembles a net 
having been draped over a solid of the 
function. 

The program first asks if you want to 
have the ‘X’, ‘Y’, ‘Z’ coordinate axes 


Jeff Harper is a high school math 


teacher who enjoys programming the 
CoCoasahobby. He is also a computer 
programming instructor for enrichment 
classes held each summer. 


Press any Key to continue 


x=[-3,3], y=[-3,3] 


drawn on the screen. Then you are 
prompted to enter the function to be 
plotted. The computer displays 2= at 
which point you should enter a func- 
tion. A typical response might be COS 
(Y)+SIN(X). 

The computer then requests the smal- 
lest and largest ‘X’ and ‘Y’ coordinate 
values. These values can have any range 
dependent only upon the function to be 
plotted. I usually get a good idea of 
what a particular function looks like by 
using a range of values from -3 to 3 for 
both the ‘X’ and ‘Y’ coordinates. At- 
tempts to plot off of the screen are 
cropped so as not to result in an error. 
‘X’ coordinate values are graphed com- 
ing toward you from the back of the 
screen, ‘Y’ coordinate values are 
graphed horizontally and ‘Z’ coordinate 
values are graphed vertically. 

A unique and particularly useful 
feature of this program is that it lets the 
user enter the function to be plotted 
while the program is running. The user 





does not need to stop program execu- 
tion, change a program line and then 
rerun the program. The transformation 
of your function into a line of BASIC 
code is simple but interesting. 

Once the function to be plotted ts 
entered, the routine beginning in Line 
970 looks for the location of Line 410 
in memory. Once located, the string 
containing your function is tokenized 
Into BASIC program Line 410. Note that 
this is done before the program ever 
reaches Line 410. Once the tokenizing 
is complete, the program continues and 
eventually executes Line 410 in the 
subroutine beginning at Line 360. This 
technique can easily be applied in other 
programs of your own creation. 

While 3DFNCPLT requires a 16K 
Extended CoCo, the routine that trans- 
forms the function into a BASIC pro- 
gram line will work on any size or 
system configuration including Color 
BASIC. 

C] 


Press any key to continue 


Z=cosy+sinx 
x=[-3,3], y=(-3,3] 
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Editor's Note: In Line 410 of the listing below, replace 
the REM marks (’) with spaces. This line is used for 
entry of the function you wish to plot and the spaces 
are required in order to reserve space for your 
function. 





The listing: 3DF NCPLT 


19 '3 DIMENSIONAL FUNCTION PLOT 
26 ‘WITH INTERACTIVE FUNCTION 
38 ‘DESIGNATION 


4p 

56 ! BY 

6p ! 

76 ! JEFF HARPER 
8p ! 2/15/85 
96 ! 


199 PMODE 4,1 
119 COLOR #,1:PCLS1 
128 LINE(#,%)-(255,191) ,PSET,B 


139 CeKEEKKKKKKKKKKRKKKKKKKRKRKEKKKS 
149 '* STEP VALUES FOR DETAIL * 
159 '* AND STRIPE SPACING k 
169 CHHEEKKKKKKKKKKKKKKKRKKRRRKRKKSK 
179 S1=.5:S2=.5:S3=1 

189 ' 

199 CLS 


269 PRINT"AXES DRAWN ON SCREEN ( 
Y/N) 2"; 

219 AS=INKEY$:IF AS="" THEN 219 
ELSE IF A$<>"N" AND AS$<>"Y" THEN 
219 ELSE PRINT A$:PRINT 
22p 

230 VHRKKKAEKKKEKKEKAKKEKKEKKKKRKKKKKKK 
249 **FIND LINE 419 IN MEMORY, * 


258 '*GET EQUATION & TRANSFORM * 
269 '*IT INTO BASIC CODE AT * 
278 ‘*LINE 419 BEFORE WE GET * 
286 '*THERE IN THE PROGRAM. * 
ZOD PHAKKKKRKAKKKEKKEKEKEREKEKEKREEKER 


328 GOSUB 1279 
319 GOTOS4g 
t 


326 

330 TRRKEAKKKEKKKKKKKKKEKKKKKKKE 

348 '*RADIAN TRANSFORMATION* 
356 Vaekakkkkkkkkkkckkkkkekhik 

368 RADIAN=(X*-.7971968) 

376 ' 

389 VaaEKRKKKKKKKKKKKKKKKKKRKKKKK 
398 '*FUNCTION TO PLOT IN 419* 
409 CHAEKKKKEKKKKEKKAEKKKKKRKEKKKKKKEK 
41M Z=XAQHYAQH eee eevee rovevenns 
Pepe eveeeeeenereeeeeeeereeeneteee 
perereerererrereneener 

426 ! 

439 CHARKEKKKKKKKKKKRKKKKKKKK 

449 '*SCALE IMAGE TO SCREEN* 

450 THKERKKEKKKKKKKEKKKKKKEKKKE 


469 NX=19*(Y+RADIAN) +128 

479 NY=192~(19*(Z+RADIAN) +96) 
489 IF NX<f THEN NX=9 

4998 IF NX>255 THEN NX=255 

599 IF NY<# THEN NY=9 

519 IF NY>191 THEN NY=191 


549 PRINT: INPUT "SMALLEST X VALU 
E" ;BX 
559 INPUT"LARGEST X VALUE";EX 
569 INPUT"SMALLEST Y VALUE"; BY 
579 INPUT"LARGEST Y VALUE";EY 
589 SCREEN 1,1 
599 IF AS="N" THEN 729 

t 


CHAERKEKKKKKKKREKKKKKKKKKKEK 


'*DRAW X, Y, AND Z AXIS* 
CHAKA KKAERKKKKKKKKKKKKKKRKK 
649 LINE(128,51)-(128,96) , PSET:L 
INE-(178,96) , PSET: LINE(127,96) -( 
183,129) ,PSET 
659 DRAW"BM199,98 U2NH2E2" 
669 DRAW"BM96,139 E2NH2NE2F2" 
679 DRAW "BM126,42 NR4E4L4" 

i] 


COD NHRARAKRERREKEKKEKKKKKEE 
799 '*PLOT FUNCTION VALUES* 
T1B NRRRHAKKKKERKKKKKKKR KK 


726 FOR X=BX TO EX STEP Sl 

739 FOR Y=BY TO EY STEP S2 

748 GOSUB 369 

759 IF Y=BY THEN LINE(NX,NY)-(NX 
,NY) , PSET:GOTO779 

769 LINE-(NX,NY) ,PSET 


779 NEXT Y 

789 NEXT X 

79p ° 

BID 'KRAEREHHERKERERRERKKER 
819 '*PLOT CROSS STRIPES* 
S2D NHKHEKHAKHKKRERHKRARE 


839 X=BX 

849 FOR Y=BY TO EY STEP $3 

859 GOSUB 369 

869 X2=NX:Y2=NY 

879 X=X+.5 

888 IF X>EX THEN X=BX:GOTO 919 

899 GOSUB 369 

9969 LINE(NX,NY)-(X2,Y2) ,PSET:GOT 
g 


919 NEXT Y 
¢ 


939 DRAW"BM49,189 USR4D4NL4BR4" 
949 DRAW"ND4R4BR4" 

959 DRAW"D4R4BU2NL4U2NL4 BR4" 
968 DRAW"NR4D2R4D2NL4BR4" 

979 DRAW"R4U2L4U2R4BR8" 

989 DRAW"R4D2L4D2R4U4BR4" 

999 DRAW"ND4R4D4BR4" 

1969 DRAW"R4U2L4U2BR4ND2BR8" 
1919 DRAW"NU4DIND3NE3NF3E1BR6" 
1929 DRAW"D4R4BU2NL4U2NL4 BR4BD4" 
1939 DRAW"R4U2L4U2BR4ND2BR8" 
1949 DRAW" BU1R2NR2NU2D5BR4" 
1959 DRAW"U4R4D4NL4BR8" 

1968 DRAW"NR4U4R4BR4" 

1979 DRAW"ND4R4D4NL4BR4" 

1989 DRAW"U4R4D4BR4" 

1999 DRAW" BUSR2NR2NU2D5BR5" 
1196 DRAW"U4BU2U1BD7BR4" 

1119 DRAW"U4R4D4BR4" 


1149 AS=INKEY$:AS="" 
1158 AS=INKEYS$:IF AS$=""" THEN 115 


9 ELSE 199 
1166 ' 
1179 CHEKKRKKKRKKKEKRKEKKKKKKKKKKKKKS 


1189 '* A BASIC SELF-PROGRAMMER* 
1199 '* AND INTERPRETER 

1299 '* BY JEFF HARPER * 
1219 '* 98/92/84 * 
1229 's * 
123 '*ADAPTED FOR THE ECB COCO* 
1249 '*FROM AN ARTICLE IN US-89* 
1259 '* MAY/JUN 1981 PG.99 * 
1269 CSS SE SSE SEE SESE SESE EL EE 2 


1276 MM=PEEK(25) *256+PEEK(26) 
1289 LN=419 

1299 MS=INT(LN/256) : LS=LN~256%*MS 
1329 M=MM 

1319 IF PEEK(M+3)<>LS OR PEEK(M+ 
2)<>MS THEN M=PEEK(M) *256+PEEK(M 
+1) :GOTO1319 

1328 ML=M+4 

1338 PRINT"ENTER FUNCTION TO PLO 
WA 

1348 LINE INPUT"Z=";E$ 
ES="Z="+ES 

1368 M=ML 

1378 FOR N=I TO LEN(ES) 

1388 Q=ASC(MID$(E$,N,1)) 

1398 IF Q=43 THEN Q=171:GOTO1519 


1499 IF Q=45 THEN Q=172:GOTO1519 
1419 IF Q=42 THEN Q=173:GOTO1519 
1429 IF Q=47 THEN Q=174:GOTO1519 
1439 IF Q=61 THEN Q=179:GOTO1519 
1449 IF Q=94 THEN Q=175:GOTO1519 


1459 IF Q=67 THEN Q=255:Q1=149:N 
=N+2:GOTO1519'cos 

1469 IF Q=84 THEN Q=255:Q1=159:N 
=N+2:GOTO1519'tan 

1478 IF Q=76 THEN Q=255:Q1=153:N 
=N+2:GOTO1519'log 

1489 IF Q=73 THEN Q=255:Q1=129:N 
=N+2:GOTO 1519' int 

1499 IF Q=83 THEN N=N+2:IF MID$( 
E$,N-1,1)="I"THEN Q=255:Q1=133 E 
LSE Q=255:Q1=155' sin or sqr 
1599 IF Q=65 THEN N=N+2:IF MID$( 
E$,N-1,1)="T"THEN Q=255:Q1=148 E 
LSE Q=255:Q1=1398' atn or abs 
1519 POKE M,Q:IF Q=255 THEN M=M+ 
1:POKE M,Ql 

1529 M=M+1 

1538 NEXT 

1549 IF PEEK(M)<>$ THEN POKE M,3 
2:M=M+1:GOTO1549 

1558 RETURN 





529 RETURN 1129 DRAW"NU4R4NU4BR4" 
539 ! 1139 DRAW"NR4U2NR4U2R4D2" ~ 
CoCo Cat 


O/ BOY’ A NEW 
C COMPUTER! 





age ustralian nbow 


azgazine 





ctoper 


M1 BON eon 
SOTROTOAM: 





FORTH 








by John Poxon 


This month I have written a program intended to 
find the roots of a quadratic equation. 
Coincidentally this may help ae certain Student's 
mother who spoke recently to Graham about 
“qguadratics". 


If "quadratic equation" doesn't ring any bells 
with you, try this. If an equation of the form AxXxx 
+ BxX + C = O exists, its roots (values of XK which 
will result on a zero) may be found by a variety of 
means, including an equation method. The roots may be 
real, zero or complex. 

I do not propose to explain the mathematics of 
this method of solution: instead I recommend that you 
consult a suitable high school mathematics text. 


The program is listed below, as it appears on my 
screen. Note that since it employs only single length 
words, no value may exceed 32768. Type it in, 
compile it and run it by entering the variables A, B 
and C and the program name, i.e. ABC Q. 


DECIMAL 

VARIABLE B8SQD 

VARIABLE 4AC 

VARIABLE 2A 

VARIABLE NEGB 

> Aw. ."” A = " ROT OUP . 

: 6B. ." B = " ROT DUP . 
Cc. ." C = " ROT DUP . 
LISTVAR A. B. C. CR CR ; 

SQBD0O SWAP DUP OUP * BSQD ! SW 

Poy 

4ACDO ROT OUP ROT * 4 * 4AC ! 


2AD0 2 * 2A! } 

-BDO NEGATE NEGB ! ; 

ICALCS SQBDO 4ACDO 2AD0 -BDO ; 
COMPLEX? BSQD @ 4AC @ - } 
B@10* NEGB @ 10 * ; 

ROOT DUP O > NOT IF DROP O EXI 
THEN DUP 2/ 2/ 2/ 2/ 1+ BEGIN 
2DUP / 2DUP - ABS 1 > WHILE + 2/ 
REPEAT ROT 2DROP ; \ _ 
NGETROOT BSQD @ 10 * 4AC @ 10° 
x - 10 * ROOT } -. 

: CGETROOT BSQD @ 10 * NEGATE 4A 
C @10 * + 10 * ROOT ; 

>: TITLE PAGE CR ." ROOTS OF QU 
ADRATIC EQUATION" CR CR ; 

: IFC1&NEG DUP O= IF SWAP DUP 0¢ 


| ae ss @©@ ss 86@ s0 wWe ee > ee ee e8 


IF ." -" SWAP THEN THEN ; 

: PRINT 10 /MOD IFCI&NEG . .” ." 
ABS . 3 

: CPRINT DUP 10 ¢ IF ." Q." . EL 
SE 10 /MOD.." ." . THEN 5; 

: NIROOT B@10% NGETROOT NEGATE + 
2A @/ ." 1ST REAL = " PRINT 3 

>: N2ZROOT B@10% NGETROOT + 2A @ / 
~" 2ND REAL = " PRINT 4 

: CIROOT Be@10* 2A @ / ." 1ST COM 
PLEX = " PRINT ." +" CGETROOT 2A 
@ / CPRINT ." J" + 3: C2ROOT B@10 
* 2A @ / ." 2ND COMPLEX = " PRIN 
T ." -" CGETROOT 2A @ / CPRINT . 
"yn | 


: NONCOMPLEX NIROOT CR N2ROOT ; 
>: ISCOMPLEX CITROOT CR C2ROOT , 


ORUMI 


Q TITLE LISTVAR 1CALCS COMPLEX 
O< IF ISCOMPLEX ELSE NONCOMPLE 
THEN 3; 


MK J ae 


I make specific acknowledgement of the source of 
the square root routine. It was written by John 
Redmond and appeared in the July 85 Coco on page 42. 

The remaining words in the program (in order) 
have the following functions. 

A. B. and C. print the value of the variable as 
entered and its name . They are contained in LISTVAR. 

SQBDO squares B and stores its value in BSQD. 

4ACDO calculates the value of 4AC and stores the 
value in the variable 4AC. Ditto 2AD0. 

-BDO negates the value of B and stores it in 
NEGB. 

1CALCS implements SQBDO, 4ACDO, 2AD0 and -BDO. 

COMPLEX? determines whether or not the quadratic 
equation has negative roots and leaves a flag on the 
stack. B@10* means get B and multiply it by 10. 

ROOT finds the single length square root of a 
number on the stack. 

NGETROOT calculates the (real) root of BSQD - 
4AC. 

CGETROOT similarly finds the (imaginary) root of 
BSQD - 4AC when 4AC is greater than BSQD. Note the 
manipulation of signs to make this possible. (Even a 
Coco can't find the square root of a negative 
number), 

TITLE prints the title. 

IFCIT&NEG tests to see if a value is less than 1 
and negative. If so a the number is manipulated to 
remove unwanted signs before printing. 

PRINT prints a "real" number using IFCV&NEG if 
necessary some number formatting is included. 

CPRINT does a similar job for an “imaginary" 
value. 

NIROOT, N2ROOT, CIROOT and C2ROOT calculate and 
print the respective real or imaginary roots. 

NONCOMPLEX calculates the real roots using 
NtTROOT and N2ROOT. 

ISCOMPLEX similarly calculates’ the 
roots. 

Q wraps the whole thing up: it 

a) prints a title, 

b) lists the values af A, By, and C, 

c) does the preliminary arithmetic, 

d) tests if the answer will] be complex or 
not, 

e) calculates a suitable answer. 


imaginary 


The program unfortunately has a tendency to 
create errors which cannot be overcome using single 
length calculations. For accuracy, a double precision 
version needs to be written. More decimal places 
should be provided and truncated. How about it? Put 
another way, when is someone. other than myself oar 
John Redmond going to write something for this 
column? 

That's it for this month. 1 don't know whether I 
can write anything for next month since my assignment 
for the U of Q (due September) are piling up, and 
also the Cococonf is upon us. 

I hope that you like my little offering. Feel 
free to ring me if you want to discuss the contents 
oft this article or other FORTH related issues. 
Regards, John Poxon. Q7 208 782Q. 
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ACCESSIBLE APPLICATIONS 


Reviewing PenPal 
Applications 


By Richard A. White 


Rainbow Contributing Editor 





ast month we began a discussion 
L: the PenPal integrated soft- 

ware package from Four Star 
Software in Canada. This month we will 
discuss additional modules, starting 
with Calc. 

Calc alone is a good, if not great, 
spreadsheet. It lacks an IF . . . THEN 

- - ELSE statement and lookup ta- 
bles, so you won't want to try to write 
an income tax spreadsheet with it. But 
it has a few neat features that make up 
for these omissions. If you want to plot 
data directly from spreadsheet files, the 
Graphit module is excellent. To make 
graphs, bar charts or pie charts, the 
Calc/Graphit combination may be the 
best available for the CoCo today. 

As with all Pen Pal applications, Calc 
is function-key driven with a function- 
key strip displayed on the bottom two 
lines of the 51 character by 24 line 
screen. There are enough functions to 
require a primary and a secondary key 


Richard White lives in Fairfield, Ohio, 
and has a long background with micro- 
computers and specializes in BASIC 
programming. With Don Dollberg, he 
is the co-author of the TIMS database 
management program. 
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strip. These are toggled by pressing 
CLEAR and ‘0’. 

Spreadsheet size is 255 columns by 
255 rows. Of course, you cannot use all 
of the cells at one time due to memory 
limitations. Still, you can use quite a 
few, since Calc is conservative in its use 
of memory. It seems to be quite compet- 
itive with DynaCalc in this regard. You‘ 
start with 26,458 bytes of buffer space, 
so very sizable spreadsheets are possi- 
ble. 

Calc saves memory in other ways. 
Numbers are saved with nine place 
accuracy using only five bytes per entry. 
This is sufficient accuracy for most 
applications. If you need more, Dyna- 
Calc works to 16 digit accuracy, but 
needs a few more bytes to store each 
number. 

When a cell is used, some memory is 
allocated for the cells in the block 
between cell Al and the newly used cell. 
This is true of most spreadsheets. If you 
delete some of the columns or rows in 
that block, you don’t immediately get 
back all the memory involved. How- 
ever, if you save and then reload the 
sheet, cell pointers are reset for best 
memory economy. 

Initially, label entry appears to be the 
same as many other spreadsheets. You 
can enter a long label, but only those 


ctober 


characters that fit the column width are 
displayed. If you move the cursor to the 
cell, more of the text is displayed in the 
cell descriptor line (line two) at the top 
of the screen. During label entry, you 
can use the ‘@’ key to backspace over 
the label to make corrections. Once the 
label is entered, there is no way to edit 
it. The same is true for numbers and 
formulas. This is Calc’s greatest weak- 
ness, which is partially compensated for 
by the ability to define a text block. 

A text block is new to me. An area 
of the screen is selected (it could be the 
whole screen, but not exceed screen 
boundaries) and defined as a text block 
using a function key. The cursor appears 
in the upper left-hand corner of the 
block. You now have a small text editor 
with which you can enter text in the 
block. Use the arrow keys to move over 
the text to do editing. Word wrap is not 
supported; you must do this manually. 
Exit a text block with the BREAK key. 

Once defined, the text block remains 
available. When you place the cursor 
within the block and press the function 
key, you go back into the text editing 
mode. When not in the editing mode, 
labels, numbers and formulas can be 
put into text block cells in the normal 
manner. Those cells are removed from 
the block and work as normal spread- 


TE 


sheet cells. This breaks the text block 
into pieces above and below, or right 
and left of the normal cells. 

If you set up a text block, write text 
into it and then change the widths of 
columns passing through the block, the 
text display is broken up. Not to worry. 
Simply put the cursor inside the block 
and use the text function key, and the 
text is reformatted. If the size of the 
block is reduced so there is more text 
than space, the text is truncated. 
Further, without word wrap, words are 
broken at the right margin and you have 
to do some editing by hand. But it’s 
better than typing it in from the begin- 
ning. Blocks can be defined for other 
purposes, including deleting, copying, 
printing and saving a portion of a 
spreadsheet either as a spreadsheet file 
or ASCII file. 


The block copy function works much 
like copy in Lotus 1-2-3 except you 
select the block first and then press the 
function key to define the block to be 
copied. Move the cursor to the upper 
left-hand cell you want to copy to and 
press the copy function key again. This 
leads us to absolute or relative address- 
ing. Here is a simple example. This 
formula is in screen location Fl: DI + 
El + #E5. When I copy it to screen 
location F2 it becomes D2 + E2 + #ES. 


Cell references DI and El are treated 
like they refer to the second cell to the 
left and the first cell to the left, and are 
adjusted to maintain this same relation 
when the formula is copied to F2. E5 is 
preceded by a ‘#’ which tells Calc not to 
adjust this cell reference. It is called an 
absolute address, which always 1s to 
reference the same cell irrespective of 
where the formula is copied. 

Calc contains a typical selection of 
trigonometric and other functions and 
operands. Like DynaCalc, formulas are 
evaluated from left to right with no 
hierarchy of operands except the por- 
tions in parentheses which are evaluated 
innermost first. As I have cautioned 
before, this can lead to incorrect results 
if you do not assure that a multiplica- 
tion or division is performed before the 
result is added or subtracted. Without 
hierarchy of operators this can happen 
unless you use parentheses to force the 
order of calculation. 

Calc has a very limited number of 
built-in formulas, including AVG (aver- 
age), MAX (maximum value in defined 
range), MIN (minimum value) and 
SUM (summation of all cells in the 
range). For each of these the range can 
be a block of cells. Whenever a spread- 
sheet offers built-in formulas like these, 
we need to know how each formula 
deals with empty cells and cells includ- 


ing text or labels. These functions 
assume that empty and label or text cells 
contain zeros. AVG(AI-AI0) assumes 
that all 10 cells in the range contain 
numbers even if one or more don't. In 
such a case an incorrect average would 
be returned. MIN(AI-A10) gets con- 
fused in the same way and returns a zero 
if there is an empty or label-containing 
cell. MAX and SUM are not affected 
and always return a correct result. 

Perhaps even more basic is the fact 
that Calc performs a calculation even 
when there are empty or label cells in 
the range. Some spreadsheets return an 
error, forcing the user to put zeros in 
empty cells and get rid of labels within 
the range. This means more work and 
untidy results. 

Those whose first spreadsheet was 
Spectaculator will remember CMT and 
RMT for cumulative sum of a column 
or row. That was all we had four years 
ago, but why include these formulas 
when the more able and understandable 
SUM is included? If you use Calc, forget 
CMT and RMT. 

Finally, a cell can be set up to receive 
a constant at the time of calculation. 
With this, you could set up a form and 
prompt the user to make entries one by 
one, assuring all required numbers are 
entered. You could type in letters or a 
word, but this shows up as a zero. It 
would be nice if words could be entered 
and placed in cells in a prompted mode. 
Then all sorts of forms could be put 
together in a spreadsheet, and be filled 
out following prompts on the entry line. 
Please, Four Star, add this to the Ver- 
sion 3 wish list. 

To set up a cell for prompted entry, 
put the cursor on the cell, press the 
formula function key and then type ? 
and the text to be in the prompt. All 
formulas are entered by positioning the 
cursor and using the formula function 
key to get into formula entry mode. 

I mentioned you can save a portion 
of a spreadsheet to a file. You can also 
merge that save or any spreadsheet into 
another. The merge starts at the current 
cursor location when merge is called 
and proceeds right and down. One 
obvious use is to move data from one 
spreadsheet to another. Another is to 
combine a number of smaller spread- 
sheets into one big one. 

There are a couple of unusual de- 
faults. If you try to print or make an 
ASCII save without previously select- 
ing a range to save or print, the screen 
is selected as the default range. Allin all, 
Calc is a nice piece of work and adds 
major value to the Pen Pal package. 

We come now to Graphit that.works 
with a Calc file to produce plots of data 
selected from the file. Similar capabil- 


ities are included in the Disk BASIC 
Version of DynaCalc, but not in the OS- 
9 version. Graphit makes line, dot or 
bar graphs in either horizontal or ver- 
tical directions. It also makes pie charts, 
and the segments can be filled with 
textures selected from nearly 100 avail- 
able choices. 

Graphit has powerful graph-labeling 
capabilities, including a selection of 
font sizes ranging from 32 to 64 col- 
umns. You also have control of the 
display style. For example, you might 
want to use light letters over a dark 
texture or surround dark letters with a 
light box over a dark background. 

Graphs may be saved to a /GP file to 
be later loaded back into Graphit, or as 
a binary file that can be loaded into 
some other graphics program, or to a 
BASIC program for display or modifica- 
tion using BASIC’s graphics commands. 
Finally, you can print graphs either 
single or double size. A number of the 
most popular printer protocols are 
supported. The pie chart prints oval on 
my LP VIII in double size, but is close 
to round in normal size. It also appears 
oval on the screen. 

Graphit works from function-key 
strips displayed only when the CLEAR 
key is pressed. It’s easy to do the basics 
and to redraw the graph in different 
ways to choose the one with most clarity 
or impact. Lettering the graph is easy, 
as is choosing and using textures for the 
pie chart. 

Graphit has only an 8,500-byte buffer 
for the spreadsheet file it is to plot. Calc 
can deal with spreadsheets three times 
that size. When working with a larger 
spreadsheet you need to save the parts 
of the sheet with the data to be plotted 
to separate small files. Now we can 
better appreciate Calc’s ability to make 
such small files. 

Telecom is a full-featured telecom- 
munication program that uses the RS- 
232 port on the CoCo. For me, this ts 
unfortunate since my port is not work- 
ing. It is also confusing, since the printer 
that works off the same plug works fine 
from the CoCo. Who said computers 
were rational? At least my diagnostics 
ROM agrees the port is bad. 


I have the Radio Shack RS-232 
ROM Pak, which both Mikeyterm and 
Desk Mate use, so I have all the telecom- 
munications capability I need. Still | 
would like to have used Telecom rather 
than just reporting on the documenta- 
tion. 


Things can get foggy in a hurry in 
telecommunications. This is partly due 
to the variety of settings and options 
available. Delphi, CompuServe and 
most microcomputer-based bulletin 
boards are fairly standard and work at 
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the default settings supplied with Tele- 
com, Desk Mate and other packages. 
Telecom has all the tools needed to deal 
with nonstandard beasts if you need to 
use them. 

You do not need a modem to use 
Telecom. You can connect directly with 
another computer in the same room or 
nearby. You will need a special three- 
wire cable called a null modem. One is 
easily made from components stocked 
by all Radio Shack Stores. You will 
need the right plug to go into the RS- 
232 plug on each computer. The CoCo 
uses an oddball four-pin DIN plug. The 
best way to get one is to buy a CoCo 
printer/modem cable, 26-3020 for 
$4.95. If connecting two CoCos, swap 
the wires to pins 2 and 4 on one plug. 
Plug the cable into the two machines, 
load the terminal programs and go. 

If you are connecting to a different 
computer, it will most likely need a 
standard, 25-pin RS-232 male plug. I 
would still start with the CoCo cable 
and replace one four-pin DIN with the 
RS-232 plug. Pins 1, 2, 3 and 4 on the 
CoCo plug go to pins 8, 2, 7 and 3 on 
the RS-232. 

If you plan to work over the tele- 
phone, you need a modem and a modem 
cable. The modem cable mentioned 
works only with Radio Shack modems. 
Other modems usually require a male 
RS-232 plug on the cable. You can make 
a cable just like the null modem cable 
above, except the wires to pins 2 and 3 
on the RS-232 plug are swapped. 

Starting at the top we come to Baud 
rate. Some years ago, 300 Baud was 
fairly standard. All communications 


services support this rate. If you are 
connecting directly to another compu- 
ter, you can use the highest rate com- 
monly supported by the two computers. 
Telecom will run at 2400 Baud provided 
the screen display is turned off. Other- 
wise, 600 Baud is recommended to 
avoid losing data. Of course, I want to 
work the bulletin board at 1200 Baud 
and I could not do that very well with 
my screen display off. Maybe I'll find a 
way if I get my serial port fixed. 

Telecom defaults to 300 Baud. All the 
other defaults look good except duplex. 
The default is not to echo typed char- 
acters to the screen. Most bulletin 
boards send back each character as they 
receive it and Telecom dutifully displays 
that character so you know what you 
typed. This is called full duplex. If you 
hook up to another computer using a 
package like Telecom, it most likely will 
not echo characters as it receives them. 
This also goes for time-sharing services 
running on IBM mainframes. So now 
you must turn half duplex on in Tele- 
com to see what you are typing. 

Telecom supports a powerful autolog 
file capability. You are able to change 
any communications parameters from 
an autolog file. Say you had been 
having a session on a local bulletin 
board and want to call up your com- 
pany’s office mail system running on an 
IBM mainframe. 

First, you empty the buffer and enter 
the IBM autolog file. Execute this file 
by pressing the function key. The first 
thing it might do is change from full to 
half duplex. Next, if you have an auto- 
dial modem, it could send the modem 


instruction to dial including the number 
to dial. Once connection is made, the 
office machine manages the user’s logon 
by asking for certain responses. The 
autolog file can contain instructions to 
look for prompts and to send specified 
character strings at each prompt which 
completely automates the logon. This 
can be particularly useful on a bulletin 
board with nested menus. You could be 
automatically logged on and have the 
mail reading started. 

When I upload or download, I nearly 
always use the CPM or Xmodem pro- 
tocol. Those are two names for the same 
thing. Basically, 128-byte buffers and a 
check digit are sent at one time. The 
receiving software recalculates the 
check digit and compares it to the one 
it received. If they check, successful 
transmission 1s acknowledged and the 
next buffer is sent. A mismatch means 
there was a transmission error and the 
sending computer is caused to resend 
the buffer. Telecom supports the Xmo- 
dem protocol. 

In summary, PenPal’s Calc is a step 
or two below DynaCalc in functions, is 
comparable in memory efficiency and 
has a superior graphing capability in 
Graphit. In some ways, Telecom is a bit 
better than the public domain Mikey- 
term and does everything most other 
terminal packages do. Couple this with 
the competent word processor dis- 
cussed last month and the file module 
yet to be discussed, and at $89.95, you 
have one of the best software values on 
any computer today. 
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66 dear fellow,” said 
y Sherlock Holmes, 


as we sat on either 
side of the fire in his lodgings on Baker 
Street. “I really wish you would con- 
sider buying a Color Computer 2 in 
place of that older model. I know that 
you are exceedingly unhappy with your 
present machine.” 

I turned to look in amazement at the 
tall spare figure seated in the armchair 
next to the Tandy 3000. A glimmer of 
of interest was present in his eyes. 

“How could you possibly know that, 
Holmes?” 

‘““Elementary, my dear Watson. I 
know from observing you at the com- 
puter that you are a two-fingered typist, 
using the index fingers of both hands. 
The tips of those fingers and those 
fingers alone have calluses, which 
you’ve been peering at intently all 
evening with some dismay, I might add. 
I also observe that you’ve replenished 
your supply of diskettes with those in 
Radio Shack envelopes, indicating a 
visit to the local Radio Shack Computer 
Center, as our seventeen local stores 
never carry more than three each, or 
three of any product, for that matter. 
The Radio Shack computer catalog is 
also lying open to the page displaying 
Color Computer products. All of these 
minutiae point to the fact that you’re 
seriously considering the new model. 
Furthermore, I saw the sales slip.” 

I could not help laughing at the ease 
with which he explained his process of 
deduction. “It is, indeed, obvious, 
Holmes.” 

“Quiet, Watson,” my friend suddenly 
whispered. “Unless I miss my guess that 
will be our friend I observed a moment 
ago coming up the stairs. We are about 
to be visited by a stout fellow approx- 
imately six feet tall, weighing 280 
pounds and wearing a T-shirt upon 
which is emblazoned ‘I Love My 
CoCo.’” 

A knock sounded on the door. 


“Come in,” Holmes replied. 

The door opened and a stout fellow 
approximately six feet tall and about 
280 pounds entered. He was wearing a 
T-shirt upon which was printed “I Love 
My Tandy 1000.” 

“Is this PCM Magazine?” he queried. 

‘I’m sorry, you have the wrong 
story,” Holmes replied, with some 
brusqueness. 

The caller made a quick egress. 
Another knock sounded at the door. 

Holmes shouted out, “Come in!” The 
door opened and a stout fellow approx- 
imately six feet tall and about 280 
pounds entered. He was wearing a T- 
shirt upon which was emblazoned “I 
Love My Color Computer 2.” 

“Close enough,” Holmes muttered. 

““Are you Sherlock Holmes, the 
famous detective?” the caller asked 
anxiously, his eyes downcast as if he 
were in deep despair. 

“Yes, Mr. Purcell-Smith,” Holmes 
replied. 

“But how did you know my name, 
Mr. Holmes?” 

“I’m afraid, Mr. Purcell-Smith, that 
you've achieved some notoriety since 
your recent marriage to Joan Purcell, 
the chief programmer of Slothware. 
How may I help you?” 

I winced as I heard Holmes use that 
pat phrase gleaned from too many visits 
to his local Radio Shack. 

“Mr. Holmes, you must help me!” 
Purcell-Smith blurted. “One of our 
programmers has been found dead and 
my wife has been arrested by Lestrade 
of the Fort Worth Yard!” 

“Calm down, man!” said Holmes, 
sternly. “Tell us your story from the 
beginning.” 

“Well, Mr. Holmes, my wife has been 
working for some time now on a new 
project for Slothware. It’s a screen 
dump program for the Color Computer. 
Never having written such a program 
before, she ran into several major 
obstacles. 

“First of all, she had to figure out how 


points on the screen were held in mem- 
ory and where that memory was lo- 
cated.” 

“That doesn’t appear to be a great 
problem,” said Holmes. “As I recall, the 
Color Computer holds its graphics 
screens starting at location 1536 dec- 
imal for nondisk systems and starting at 
location 3584 decimal for disk systems. 
Each screen is 6,144 bytes long for 
graphics modes 3 and 4. For graphics 
mode 3, 128 by 192, there are 24,576 
elements of two bits each. For graphics 
mode 4, there are 49,152 elements of 
one bit each.” 

As Holmes spoke, he rapidly 
sketched two drawings, one represent- 
ing the 128 by 192 two-color graphics 
mode 3 and the second representing the 
256 by 192 two-color graphics mode 4 
(see figures | and 2). 

“I wrote a monograph on the subject 
after my episode involving the Giant 
Computer of Sumatra. But please con- 
tinue, Mr. Purcell-Smith.” 

“The next problem my wife ran into 
was computer graphics. It seems that 
most Radio Shack printers use the same 
scheme for graphics, one involving 
seven bits per character position.” Our 
visitor paused and shot a baffled glance 
at Holmes. 

“Ah, yes. The singular seven-bit 
problem. An interesting exercise. It 
appears that early in the printer game 
someone at Radio Shack decided to 
design a graphics printer. Most printers 
at the time used a five by seven dot 
matrix for each character. Each ASCII, 
or text, character was converted by the 
printer electronics into a series of five 
vertical columns, each column consist- 
ing of seven possible dots.” He sketched 
another rapid illustration on the bottom 
of a Persian slipper (see Figure 3). 

“What could have been more natural 
than implementing graphics in the 
existing printers than to make each one 
of those seven print wires or print 
positions programmable in graphics 
mode. All that was required was a 
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command to ‘set graphics mode’ in the 
printer. After graphics mode was set, 
the printer decoded each character that 
came to it as a coded form of which of 
those seven wires to print. The only 
requirement for each graphics character 
was it could not be in the normal range 
of ASCII characters from zero through 
127. It must be in the range of 128 
through 255.” 

“Yes, Mr. Holmes, I understood that 
part of it, but could not see how the 
encoding took place.” 

“Imagine that the topmost dot of 
each column was represented by a one, 
the next by a two, the next by a four, 
the next by an eight, the next by a 16, 
the next by a 32, and the last by a 64. 
Once graphics mode is set, you simply 
have to add the dot values for the 
column plus [28 to mark graphics 
mode. Let me illustrate.” 

Holmes took out a pistol and aimed 
it at a spot on the wall next to the letters 


“M. T.” created by bullet holes. (Victo- 
ria Regina had yielded to Maggie 


Thatcher years ago.) 

“Suppose you wanted to print the 
upper three dots and the bottommost 
dot in a graphics column.” He fired the 
gun four times to denote the column. 
“The code for the graphics column 
would be one plus two plus four plus 64 
for the bottommost column plus 128 to 
mark the character as graphics. That 
would be a total of 191.” 

“But how would that 191 value be 
sent to the printer, Mr. Holmes? You 
can send text by doing a PRINTH-2 of 
a string, but how can a nonprintable 
character be sent?” 

“By using the CHR$( ) function, Mr. 
Purcell-Smith. As a matter of fact, 
many printer codes are sent to the 
printer from BASIC by using the 
CHRS( ) function. To set graphics 
mode, for example, you’d do aPRINT#- 
2,CHRS(27)3CHRS(XX). To print the 
graphics column we’ve been discussing, 
you'd do a PRINT#-2,CHRS(191);. 
Use a semicolon at the end if you don’t 
wish to end the line.” 

“But,” said he, “pray let us continue 
our conversation on the way to the 
location of the demise of that poor 
programmer chap.” 

There was a cab passing as the three 
of us came out of the building, and 
Holmes hailed it. “Beckenham, if you 
please.” 

Our driver pulled up at a greystone 
that housed a high-tech industry. He 
knocked on the door, and a tall, dour- 
looking man appeared. 

“Ah, Lestrade,” Holmes said. I see 
you have apprehended the killer and are 
putting the finishing touches to this 
little mystery.” 

“Yes, Mr. Holmes. It was a simple 
ust 
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Figure 1: 128 x 192 Four-color 
Graphics Mode 


crime, really. Ms. Purcell was jealous of 
her chief programmer and afraid that 
even with affirmative action he would 
soon replace her at Slothware. She 
laced his coffee with arsenic as he was 
putting the final frills on a screen dump 
program.” 

“In that case, Lestrade, you won’t 
mind if we have a look around, will 
you?” 

“Of course not, Mr. Holmes, al- 
though I’m certain you won’t be finding 
anything that I haven’t seen already.” 

Holmes walked over to the program- 
ming area and picked up a listing next 
to a Color Computer. “Hmm. This 
appears to be a listing of the screen 
dump program in question, gentlemen. 
Let me peruse this briefly.” 

After intently peering at the docu- 
ment, the detective picked up a second 


Byte N 


listing. He then glanced around the 
room at several printers connected to 
the Color Computer. Taking out a 
pocket measuring tape, he made precise 
measurements of figures produced by 
the several printers. 

“Watson, I think our task here is 
done. Lestrade, I think if you look in 
that programmer’s desk drawer you'll 
find a vial of arsenic with his finger- 
prints on it, prompting you, I should 
think, to release Ms. Purcell from your 
custody. Let us be off, gentlemen.” 

Later that evening the three of us sat 
in front of a blazing fire in Holmes’ 
Baker Street apartment. 

“Mr. Holmes, I cannot thank you 
enough! My wife has been released and 
Lestrade has ruled the death a suicide.” 

“My blushes, Mr. Purcell-Smith. It 
was just a trifle.” 
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“But, how did you know the death 
was a suicide?” 

“T looked in some detail at the listing. 
It appears that the dead programmer 
had been trying for some time to design 
a screen dump program for the Color 
Computer. It was apparent he was 
having problems, however. The revision 
number of the BASIC program was 
number 45, indicating that he had 
attempted 44 times to write a program 
that successfully dumped the screen.” 

“But surely he must have known 
about the CHRS command, memory 
layout of the graphics screen and coding 
of graphics characters?” 
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Figure 3: Dot Representation 
of Characters and Graphics 





‘Yes, he was familiar with those 
functions for the screen dump program. 
However, he encountered a host of 
other obstacles. First, he found a prob- 
lem in translating one pixel on the 
screen into one printable spot. Consider 
one approach he might have used. If he 
made one pixel equal to one printable 
character, then he would have had a 
screen dump of 25.6 inches in width by 
32 inches high for the 256 by 192 mode, 
as the usual number of characters per 
width horizontally is 10 characters per 
inch and the number of vertical lines per 
inch is six. He was forced to use graph- 
ics mode to get a small enough listing. 

‘*‘However, he knew he could not 
print one pixel at a time on the printer, 
as seven vertical dots are printed for 
every graphics character. Therefore, he 
had to construct a graphics character 
made up of the seven vertical pixels on 
the screen. Here, Ill show you what I 
mean.” 

Holmes grabbed a nearby coal scuttle 
and drew a figure on it with a marking 
pen. 

“He had to repeat that process for the 
entire row of 256 characters. When he 
coded the program, however, he found, 
to his amazement, that the figure pro- 
duced by the screen dump was too 
small. The width was 256/60 inches 
wide, as most Radio Shack printers 
print 60 dots per inch in normal mode. 
The 4.4-inch width however, did not 
match the height. Most Radio Shack 
printers space graphics lines at 0.12 


inches vertically, about eight lines per 
inch. As he had to print 27 3/7 graphics 
lines to produce 192 pixels vertically, he 
found the vertical dimension of the 
screen dump figure was 3.3 inches. A 4.4 
by 3.3 inch figure wasn’t to his liking. 

“On his next attempt, he printed two 
graphics characters for every column of 
seven pixels.” Holmes continued the 
sketch (see Figure 4). 

“To do that, however, he had to make 
each graphics character represent 3.5 
pixels, drawing two graphics dots for 
each pixel on the screen. That proved 
to be more laborious programming 
because he had to alternate between odd 
and even numbered lines. Each even line 
on the printer represented the next three 
pixels and the top half of the next. Each 
odd line represented the bottom half of 
the last pixel and the next three pixels. 

“He wrote his next revision using 
these criteria. The result produced a 
print image of 8.5 inches by 6.6 inches. 
However, he encountered a strange 
problem. The line printer would not 
print the entire line of graphics charac- 
ters without advancing to the next line. 
After much deliberation, indicated by 
revisions 20 through 23, he found that 
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Color Computer BASIC counted the 
number of characters in each line and 
assumed each character was a text 
character. After 132 characters, in the 
typical case, BASIC would automatically 
send a new line to the printer, assuming 
that no printer would have greater than 
13.2 inches for each line. That would be 
true had the printer been printing text, 
but not 512 graphics characters occupy- 
ing 8.5 inches. 

“In his next revision he cleared the 
BASIC variable that defined the number 
of characters per line to zero, eliminat- 
ing that problem. 

“The unfortunate programmer fi- 
nally had a program that would print a 
256 by 192 pixel screen in PMODE 4. With 
a few more modifications, he created a 
new revision that would also print in 
PMODE 3, the four-color 128 by 192 
mode. 

“In the process of running the screen 
dump program, however, he timed tt. I 
would guess by the nested loops and 
‘overhead’ of the program it would take 
approximately 52 minutes to print out 
the screen. Our friend knew this would 
be unacceptable as a product. 

“He then set out to convert the BASIC 
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gram did execute quite rapidly, about 
eight minutes for each screen print. One 
can surmise that he went with good 
spirits to his employer, Ms. Purcell, to 
show her his accomplishment. At this 
point he was many days overdue. Ms. 
Purcell has confirmed that he did, 
indeed, show her the program. When 
they went to try it on her CGP-220 
printer, however, the proportions were 
quite far off — 6.4 inches horizontally 
by 6.6 inches vertically, as a matter of 
fact. Our friend was aghast until he 
found out that the CGP-220 printer 
printed 80 graphics columns per inch. 

According to Ms. Purcell, he then 
attempted to run the program on the 
DMP-110 dot-matrix printer. Again the 
proportions were off — 4.2 inches by 5.5 
inches. To his dismay he found the 
DMP-1!110 used 120 graphics columns 
per inch! At that point, according to 
Ms. Purcell, he returned to his desk, in 
a kind of daze, repeating the words ‘too 
many printers, too many printers.’ She 
found him an hour later in the rictus of 
death clutching his last listing, which I 
have here.” Holmes pulled out the last 
listing and placed it in front of us. 

“The ironic part of this story, gentle- 
men, is that his last listing worked for 
most Radio Shack printers. Such is the 
life of a programmer! Let us hope our 
friend has received his eternal reward 
for his efforts and is employed in a 
heavenly capacity on a system with one, 
and only one printer.” 


How to Use the Screen 
Print Programs 

There are three versions of the screen 
print program. Each runs on any Radio 
Shack printer that has “dot graphics” 
capability, including earlier printers 
such as the LPVIII, DMP-100, DMP- 
program to Color Computer assembly 
language. The poor fellow had a nod- 
ding acquaintance with assembly lan- 
guage, but did not realize what a labor- 
ious task the conversion would be. 

“After hours and many program 
revisions, presumably, he produced this 
listing.” Holmes thrust a soiled, tattered 
piece of paper at us. “In fact this pro- 
print one pixel at a time on the printer, 
as seven vertical dots are printed for 
every graphics character. Therefore, he 
had to construct a graphics character 
made up of the seven vertical pixels on 
the screen. Here, I’ll show you what I 
mean.” 

Holmes grabbed a nearby coal scuttle 
and drew a figure on it with a marking 

en. 

“He had to repeat that process for the 
entire row of 256 characters. When he 
coded the program, however, he found, 
to his amazement, that the figure pro- 
duced by the screen dump was too 
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small. The width was 256/60 inches 
wide, as most Radio Shack printers 
print 60 dots per inch in normal mode. 
The 4.4-inch width however, did not 
match the height. Most Radio Shack 
printers space graphics lines at 0.12 
inches vertically, about eight lines per 
inch. As he had to print 27 3/7 graphics 
lines to produce 192 pixels vertically, he 
found the vertical dimension of the 
screen dump figure was 3.3 inches. A 4.4 
by 3.3 inch figure wasn’t to his liking. 

“On his next attempt, he printed two 
graphics characters for every column of 
seven pixels.” Holmes continued the 
sketch (see Figure 4). 

“To do that, however, he had to make 
each graphics character represent 3.5 
pixels, drawing two graphics dots for 
each pixel on the screen. That proved 
to be more laborious programming 
because he had to alternate between odd 
and even numbered lines. Each even line 
on the printer represented the next three 
pixels and the top half of the next. Each 
odd line represented the bottom half of 
the last pixel and the next three pixels. 

“He wrote his next revision using 
these criteria. The result produced a 
print image of 8.5 inches by 6.6 inches. 
However, he encountered a strange 
problem. The line printer would not 
print the entire line of graphics charac- 
ters without advancing to the next line. 
After much deliberation, indicated by 
revisions 20 through 23, he found that 
Color Computer BASIC counted the 
number of characters in each line and 
assumed each character was a text 
character. After 132 characters, in the 
typical case, BASIC would automatically 
send a new line to the printer, assuming 
that no printer would have greater than 
[3.2 inches for each line. That would be 
true had the printer been printing text, 
but not 512 graphics characters occupy- 
ing 8.5 inches. 

“In his next revision he cleared the 
BASIC variable that defined the number 
of characters per line to zero, eliminat- 
ing that problem. 

“The unfortunate programmer fi- 
nally had a program that would print a 
256 by 192 pixel’Screen in PMODE 4. With 
a few more modifications, he created a 
new revision that would also print in 
PMODE 3, the four-color 128 by 192 
mode. 

“In the process of running the screen 
dump program, however, he timed it. I 
would guess by the nested loops and 
‘overhead’ of the program it would take 
approximately 52 minutes to print out 
the screen. Our friend knew this would 
be unacceptable as a product. 

“He then set out to convert the BASIC 
program to Color Computer assembly 
language. The poor fellow had a nod- 
ding acquaintance with assembly lan- 
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guage, but did not realize what a labor- 
ious task the conversion would be. 

“After hours and many program 
revisions, presumably, he produced this 
listing.” Holmes thrust a soiled, tattered 
piece of paper at us. “In fact this pro- 
gram did execute quite rapidly, about 
eight minutes for each screen print. One 
can surmise that he went with good 
spirits to his employer, Ms. Purcell, to 
show her his accomplishment. At this 
point he was many days overdue. Ms. 
Purcell has confirmed that he did, 
indeed, show her the program. When 
they went to try it on her CGP-220 
printer, however, the proportions were 
quite far off — 6.4 inches horizontally 
by 6.6 inches vertically, as a matter of 
fact. Our friend was aghast until he 
found out that the CGP-220 printer 
printed 80 graphics columns per inch. 

According to Ms. Purcell, he then 
attempted to run the program on the 
DMP-110 dot-matrix printer. Again the 
proportions were off — 4.2 inches by 5.5 
inches. To his dismay he found the 
DMP-1I1I0 used 120 graphics columns 
per inch! At that point, according to 
Ms. Purcell, he returned to his desk, in 
a kind of daze, repeating the words ‘too 
many printers, too many printers.’ She 
found him an hour later in the rictus of 
death clutching his last listing, which I 
have here.” Holmes pulled out the last 
listing and placed it in front of us. 

“The ironic part of this story, gentle- 
men, is that his last listing worked for 
most Radio Shack printers. Such is the 
life of a programmer! Let us hope our 
friend has received his eternal reward 
for his efforts and is employed in a 
heavenly capacity on a system with one, 
and only one printer.” 


How to Use the Screen 
Print Programs 

There are three versions of the screen 
print program. Each runs on any Radio 
Shack printer that has “dot graphics” 
capability, including earlier printers 
such as the LPVIII, DMP-100, DMP- 
400, DMP-2100, and so forth. The 
screen print programs also run on newer 
Radio Shack printers when the printers 
are set to the Tandy character set. 
Newer printers have a switch selection 
that enables either Tandy or IBM char- 
acters to be used. The reason for this is 
the printers are used in the Tandy 1000, 
1200, 2000 and 3000 — systems which 
are IBM PC compatible. These systems 
not only use a different character set, 
but also use a different escape code 
sequence, one which is Epson printer 
compatible. Unfortunately for the pro- 
grammer in our story, the new printers 
arrived too late. The Epson escape-code 
sequence uses an eight-bit encoding 
which is a great deal easier to work with 





than the seven-bit coding. 

The first program, shown in Listing 
1, is a BASIC program that. works for 
either PMODE 4 (256 by 192) or PMODE 
3 (128 by 192). To use the program, key 
it in as a subroutine starting at Line 
10000. Then call it from your BASIC 
program at any time to print out the 
graphics screen. 

Before you do, however, change Line 
10010 to 2P=1536 for a nondisk system 
or to 2P=3584 for a disk system. 
Change Line 10020 to Z2M=1 for PMODE 
4 or to 2M=2 for PMODE 3. If you have 
a printer such as the DMP-110 which 
prints at a dense resolution in graphics, 
change Line 10030 to ZW=1; otherwise 
leave 2W=0. The program takes about 50 
minutes to execute. 

The second version of the program is 
an assembly language implementation 
of the same program shown in Listing 
1. In this program we tried to do a 
Straight translation between the BASIC 
version and assembly language so that 
you could see the flow in assembly 
language. Change the variables where 
indicated for disk /nondisk, PMODE 3 or 
4, and high-density printing at the 
beginning of the program. Assemble 
and load the program using the Disk 
EDTASM or another assembler. The 
program its designed to execute at loca- 
tion $3E00,so you'll have to do aCLEAR 
10@,&8H3DFF in your BASIC program 
before loading the program. You can 
then call the machine language code of 
the program by defining the location of 
the program with a DEFUSR@=&H3E04 
and an A=USR®@(@) or with a POKE 
126,XX: POKE 127,XX and an 
A=USR(@) in non-Extended BASIC. This 
assembly language version takes about 
8 minutes to print. 

If you would rather use the program 
as a BASIC version, entér the program 
shown in Listing 3. This is the exact 
Same version as Listing 2, except the 
machine code has been entered as a 
series of DATA values. These values are 
relocated to the $3E00 area the first time 
the program is called. Thereafter the 
program is executed by executing the 
machine code at the $3E00 area. You 
must first do a CLEAR 100, &H3DFF in 
your BASIC program before executing 
the program so that the $3E00 area is 
protected from BASIC use. Change the 
variables as before for the PMODE, disk/ 
nondisk system and printer type. 

The PMODE 3 version prints nonzero 
colors as foreground (print) and zero 
colors as background (no print). 

A sample printout using the program 
is shown in Figure 5. This figure illus- 
trates the graphics characters available 
in graphics mode by using the Character 
Generator discussed in last month’s 
column. 


TANDY 





Listing 2: 
JEgs 

JEg9 IEP 
3Eg2 gl 
3e93 99 


JE94 B6 30 JEG2 
3E97 49 
3E98 BY 3F46 


3f98 66 8612 
3290 BD = 3F 36 


E19 4F 
3E1l B87) |= 34S 
3E14 BY 3 ¥48 


3E17 47 
3£18 B70 | -3F42 


JELB 8607 
3ELD B70 343 


3229 6 0343 
3223 OF 
322417 gh 
3226 C6 Og 
3828 6c 30g 999 
3228 27 ig 
3E2D 58 

3222 39°F 
3E39 26 
3232 B60 SEG2 
3E95 81 92 
337 260g 
3239 56 

JEIA FA FS? 
3230 F709 947 


3E49 198E 9999 


a EE Eo 


COLOR COMPUTER 





Figure 5: Sample Printout 
Using Hi-Res Program 


99119 “HI-RES SCREEN PRINT 

ggl2g ORG $3Egg 

99139 *ZP=3564 "CHANGE TO ZP=1536 FOR NON-DISK SYSTEM 
99149 2P FDS 3384 

P9159 *ZMe@l "CHANGE TO ZM=2 FOR 128X192 RES 


99169 2M FCB 
99L?79 *ZWeg ‘CHANGE TO ZV=L FOR OMP-119 
g9leg zv FCB 


TS Eh Se ee 

99229 START LDA y4.| 

99239 NEGA -ZM 

99249 STA zs INI? Zs 

GPIASF Woewecccweewcncwcrncccccercecc ccc cece cess cece ncene 

99269 PRINT w-2,CHRS(18); 

JPA Wo cwwccccwccccesecccwccwnceccccccccc cscs secs esceane 

gg289 LDA 018 SET GRAPHICS 

99299 JSR PRINT 

TE ee ha ee 

99319 *FOR ZR-J TO 191 STEP 3.5 

RS Be ee 

99339 CLEA 

99349 STA ZR INITIALIZE ZR 

g935s¢ STa zt 

el) ee ee Se eS 

99379 *FOR ZC=9 TO 31 

TBS ee 

99399 HIRG69 CLEA 

99499 STA zc INITIALIZE ZC 

TS OI 

99429 “FOR ZB-7 TO 9 STEP ZS 

POSS We ccc w ccc cwccwwne ccc cc ccwwcw wes cece cnnccccoccerce= 

99449 HIRG79 LDA o? 

99459 STA r4-| INIT ZB 

DDS ee ee 

99479 *22—2°ZB : IF ZH=2 THEN ZZ=Z2Z+2°(2B-1) 

JPSEG Bon rnernen re cnn err en nen en nme e we cenennennncceewccces 

99499 HIRgss LDB zB GET @# OF TIMES 

99599 CLRA 

gosig TFR B.X 

99529 LDS el 

99539 CuPx og 

99349 BIRgS6 BEQ HIRg87? GO IF 9 

99539 LSLS SHIFT LEFT ; 

gg9seg LEAX °1,X DECREMENT 

g9s7¢ BNE WIRg86 CONTINUE IF NOT DONE 

ggseg LDA zM 

g9so9 CHPA #2 

g9eg9 “BNE BIRg8?7 

ggelg LSRB 

ggs2g ORB 2z 

99639 HIRGG7? STB zz 

) TT) ee ee eer ee 

99659 *FOR ZN=g TO 3 

GJIEEG Wocwn mn enn en nnn n nena enw enc cn wwe nec ee nn ceo sneccnes 

99679 LoY og 

TCT TB eee 

99699 WIV (PEEK(ZP+ZC+( INT(ZR)+ZN)*32) AND ZZ)>9 THEN 

P97IPP #ZC(ZN)ml ELSE 2G(ZN)<~ 

PPILG Wp ne nnn nn nn nnn nnn nn nnn nnn nnn nner en nen e nee c erences 
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4846 OF 99729 HIRG99 CLRA JED4 EB ES 9isog ADDB Ss Z2G(1)#6426(2)*24426(3) #96 
3E45 A? «Ad 3749 «699739 STA ZG.Y ELSE ZG(ZN)=9 JED6 EY = E4 g1sig STB Ss 
3269 1F 29 99749 TTR 1D 3ED8 BG 0349 gis2g LDA ZG ZG(9) #1 
3E6B F703 F446 99759 STB 2M JEDB C6 9k 91539 LDB wl 
SESE FG 0 JF4S 99769 LDB ZR zB 3EDD 30 Gi5eg MUL 
3ESL FB R44 99779 ADDB s2N 2R+2N JEDE EB OEg g155g ADDB ,S+ 2G6(9)#1+ZG(1) #64+26(2)#24426(3)@ 
3ES6 86 0629 99789 LDA 932 96 
3ES6 3D 99799 MUL (ZR+ZN) #92 JEEQ CB 89 g1sé¢ ADDS #128 
3E37 F3 0 SEGg 99899 ADDD _2P ZP+ZC+(ZR4ZN) #32 3EE2 F703 F49 1579 STB zG 
JESA 36) 96 ggelg PSHS =O GL5B9 #---- nem n nnn nnn ene e eens er een enn reece eee cc ene see 
JESC 4P gge2g CLRA J1l599 “PRINT @-2 ,STRINGS(ZM*2+ZW,ZC$) 
3ESD F603 F42 99839 LDB zc G1GEPF Ho - nnn nnn nme nn nn nnn wenn wenn new cee neem een een eeeeee 
E69 £3 El ggssg ADDD S++ 3EES F6 JE92 gl619 HIRI29 Lbs ra. 
3262 1F gl ggesg TFR Dx JEES 58 gl629 LSLB ZH? 
3B64 AG 84 ggecg LDA x PEEK (ZP+ZC+(ZR+ZN) #32) JEE9 FB ESI gl639 ADDB zw 
3E66 BA =F 47 g9a79 ANDAs 22 AND 2Z JEEC 1F 91 91649 TFR Dx 
3269 27 96 ggasg BEQ HIRI99 IF (PEEK)... AND 2Z)<9 JEEE BG =F 49 91659 HIRL25 LDA zG 
3E6B 86) 9 ggaog LDA el 3271 BD 33 F396 91669 JSR PRINT 
3E6D A? a9 3F49 «99999 STA 2G,Y THEN 2C(ZN)=1 SERA 390 oP g1679 IwaX = «1, X 
PPILI Wann nnn nnn nnn n wenn nen ne wenn en en en wen nese cc eres ones 2EF6 266 gicag BNE HIRL2$ 
99929 *NEXT ZN 2.) See eee ee ee 
G9IID Wo ~~ nwa nn nnn enn wwe receweneen nner eens seen newecence P1799 *NEXT 28,ZC 
3JE71 31021 g9949 HIRIGP9 LEAY +1, STE? 1 JLILD Woennwwww nec mn ecw cncccccne cence cece ccc wnnccccnccccce 
3273 1F |. 99959 TFR Y.D GET 2N 3EF6 BG 40-3 F46 9l729 HIRL39 LDA zs CET zs 
3275 1983 ggg 99969 CHuPD 04 a4? 3EFB 34 92 g1739 PSHS A 
3E79 26 G9 y9979g BNE HIRG99 CO IF NO JEFD 386 3F43 gil749 LDA zB 
3E7B BG SF 4S 99989 LDA 3799 AB Ogg gl759 ADDA ,S+ STEP ZS 
JE7E 81 = BD 99999 CHRA = @ 189 392 B70 3 F43 g176g STA z3 
JE89 260 «98 91999 BNE HIRLGS 3F9S 192C FFL? g1779 LBGE  HIRG89 GO IF zE<¢ 
GLPLG Women mane n mewn mene nnn nme w nee ew een c nner sence cece 399 70 = 3F42 g1789 INC zc 
$1929 *IF ZR=189 THEN 26(3)=9 3F9C B60 342 gi79g LDA zc 
J1LPIP Poon m nnn nnn nw nen n nnn nnn eer enwee ewes new ee ween esnc nee 3F9F 81 8629 glsgg CHPA ss #32 ZC=32? 
3E82 86 = 9g 91gsg LDA #9 J¥F1L 1926 FFg6 gisig LBNE  BIR979 GO IF NO 
3E84 31 3F glgsg LEAY “1,7 Se ee 
3286 A?) «= aD F491 g6g STA 2G,Y 91839 “PRINT 9-2 
JIPTG W------ mn nm mene newer c enn e ene n nee ween new e ws ecocce OO a 
91989 WIF ZR/2-INT(ZR/2) THEN ZGSHCHRS (1284+26(9) #34 3715 86 go gissg Lda e$D CR 
Jlig9d * 72C6(1)#124+26(2)%484+26(3) #64 3F17 BD 3736 gissg JSR PRINT 
GL1PP W------- enn n nnn nnn nnn ne sewn ewww ewww nen enenenccce Oe 
JESA B6 3F48 Jillg HIRIgS LDA zt GET 72T 9.889 “NEXT ZR 
328D 8& =o g1129 ANDAs ak TEST ODD/EVEN OO 
3E8F 26 2B gii3sg BNE HIRL19 Go IY ODD SPlA 36 3748 giogg LDA ZT CE? 2T 
JE9L B6é 3¥4c gilsg LDA ZG+3 3F1D 84 gi g19ig ANDA el 
JEI4 CE AY PLisg LDB 064 3FLY BB OIFSS g1929 ADDA ss ZR 
3296 3D gllég MUL 2G(3) #66 3722 8B Og g193g ADDA #3) 
3E97 34 gh gi17g PSHS B 3724 87 09-3 F4S g194g STA zn 
3E99 BG =F 4B gi1sg LDA 2642 3F727 7 =. 3748 91959 INC zt 
3E9C ce Og gll9g LDB 048 3F2a 810 cg g196g CHPA =s«#192—s«ACTT.:sOEND?P 
1292 3D gl299 MUL 2C(2) #48 3¥2C 1926 FEE? gi979 LBNE 4HIRg69 GO IF NO 
JE9F EB ES gl21g ADDB Ss 26(2)#48+26(3) #64 JLIBY Woo cern nnn mn nnn nnemerwoccw cece c cece ewe seennnenne 
3JEAL EJ £6 91229 STB Ss 91999 *PRINT #-2,CHRS(39); 
3EA3 BG IF4A 91239 LDA ZG+1 J2GIP B- nn nnn nnn nnn en nnn nn wenn nn enn wenn e een eee e ee nee 
3EA6 C6 ogc gl24g LDB o12 3F3g9 86) OLE g2919 LDA aiy RESET GRAPHICS 
JEA8 3D gl2s9 MUL ZG(1) #12 3732 BD 0-3 F 36 92929 JSR PRINT 
JEA9 EB ES 91269 ADDB s 26(1)#12+ZG(2)*48+Z6(3) #64 J2I3IF Boon anew nnn nnn en sae renew ewer eer en seer eres ceesnnes 
JEAB E7 ES gl279 STB Ss 92949 *RETURN 
JEAD BG 9-49 gl2sg LDA z¢ Po) Se 
JEBQ C6 O93 g1299 LDB #3 3735 39 92969 aTS 
3EB2 3D 91399 MUL 2G(9)*3 NE 
JEB} EB OEG gl31g ADDB- es, S+ ZG(9)*3+ZG(1)#124ZG(2)#48e... 3¥36 C6 CFE 92989 PRINT LDS e-2 
JEBS CB OA8g 91329 ADDB 128s 1738 D7 OG 92999 STB $6F 
3287 F7 = F49 gl33g STB 2G JF34 AD =69F AMP2 92199 Ist (SA992] 
JEBA 29 49.29 glisg BRA BIR129 IFIE OF g211g CLRA 
SP 3737 97 = 9C 92129 STA $9¢ 
J1369 *ELSE ZCS—CHR$(120+ZG(9) #1 +Z6(1) #6 +26(2)#246426(3) #96 3¥41 39 g2139 RTS 
glj7g Wee een nec cc cece en nn wee nee c cee e ence cece cee ncce 92149 a ee a 
JEBC B6 0-3 Fae gl389 HIR11g LDA 264) 3742 gg g21sg zc rcs g 
JEBF C6 OG g1399 LDB 096 3743 99 g2ieg ZB FcB g 
3EC1 3D glogg MUL 26(3) #96 3F46 99 92179 2 ¥CB g 
3EC2 340g glaig PSUS B 3745 99 g2189 ZR FCB 9 
JECG B60 F4B g142g LDA 2642 IF46 99 92199 zs rcs g 
3EC7 C618 glaig LDB 024 3747 99 92299 22z rcs g 
3EC9 3D FLang wuL 26(2) #26 346 99 92219 27 rag 
Ecc 7 re a1aép sts. ; ZO(2)8244726(3) #96 3F49 99 92229 ze FCB 9 
JECE BG 034A gl47g LDA ZC+L sEpS 92299 END START 
SEDL CS og glssg LDB 96 
JED} 3D glsog MUL 2G(1) *6 999IT TOTAL ERRORS 
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Listing 3: MLPRINT 


198 "HIGH-RES SCREEN PRINT TEST 


119 CLEAR 109, &H3DFF 

128 FOR I=SH3EQ% TO &H3F49 
130 READ A: POKE I,A 

149 NEXT I 

150 DEFUSR@=6&H3E04 

168 SCREEN 1,9 

178 PMODE 4,1 


189 PCLS 


19% FOR I=l TO 5 


260 CIRCLE (RND(255) ,RND(191)), 


RND (19) 


219 LINE (RND(255) ,RND(191))-(R 


ND(255) ,RND(191) ) , PSET,B 


226 NEXT 


I 


232 A-USR# (Pf) 


249 GOTO 
250 ! 

260 DATA 
270 DATA 
280 DATA 
298 DATA 
300 DATA 
310 DATA 
320 DATA 
330 DATA 
349 DATA 
356 DATA 
360 DATA 
379 DATA 
389 DATA 
398 DATA 
490 DATA 
419 DATA 
426 DATA 
436 DATA 
446 DATA 
450 DATA 
460 DATA 
479 DATA 
489 DATA 
499 DATA 
599 DATA 
519 DATA 
529 DATA 
536 DATA 


240 


SHE ,&H2 ,&H1 ,&HP 
SHBG , SH3E,6&H2 ,&H49 
&HB7 , &H3F, &H46 , &H86 
&H12 , SHBD, &H3F, &H36 
&H4F, &HB7 , &H3F, &H45 
&HB7, SH3F, &H48, &H4F 
&HB7 , SH3F, &H42 , &H86 
&H7 ,&HB7, &H3F, &H43 
&HF6 , SH3F, &H43, SH4F 
SHIF,&H1 ,&HC6, &H1 
&H8C,&HS ,6&H% , &H27 
&H19 , &H58 , &H30, &H1F 
&H26, SHF9, &HB6, &H3E 
&H2 ,&H81,&H2 ,&H26 
&H4 ,&H54, SHFA, &H3F 
&H47 , &HF7 , SH3F, &H47 
&H19, &SH8E,&HP , &HP 
SH4F, &HAT7, &HA9 , SH3F 
&H49, &SHIF, &H20, &HF7 
SH3F, &H44, &SHF6, &H3F 
&H45, SHFB, &H3F, &H44 
&H86, &H29 , &H3D, SHF3 
&H3E,&HD ,&H34, &H6 
SH4F, SHF6 , &H3F, &H42 
&HE3 , SHE], &SH1F, &H1 
SHAG , &H84 , &HB4 , SH3F 
&H47, &H27,8H6 , &H86 
&H1 ,&HA7,&HA9, SH3F 


549 DATA 
550 DATA 
569 DATA 
579 DATA 
580 DATA 
599 DATA 
600 DATA 
619 DATA 
620 DATA 
630 DATA 
646 DATA 
658 DATA 
668 DATA 
676 DATA 
688 DATA 
699 DATA 
79% DATA 
719 DATA 
720 DATA 
739 DATA 
749 DATA 
759 DATA 
76% DATA 
77% DATA 
789 DATA 
799 DATA 
890 DATA 
819 DATA 
829 DATA 
839 DATA 
849 DATA 
859 DATA 
868 DATA 
879 DATA 
889 DATA 
899 DATA 
990 DATA 
919 DATA 
929 DATA 
939 DATA 
949 DATA 
959 DATA 
969 DATA 
979 DATA 
989 DATA 
999 DATA 


&H49 , &H31, &H21, &HIF 
$H29, &H19, &H83, &H2 
&H4 ,&H26, &HC9, &HB6 
SH3F, &H45, &H81, &SHBD 
&H26,6H8 ,&H86,&H2 
$H31, &H3F, &HA7, &HA9 
&H3F, &H49, &HB6, &H3F 
&H48, &H84,&H1 , &H26 
&H2B, &HB6, &H3F, &H4C 
SHC6, &H4 9, &H3D, &H34 
&H4 , &HB6, &H3F, &H4B 
&HC6 , &H39, &H3D, &SHEB 
&HE4 , &SHE7, &HE4 , &HBG6 
SH3F, SH4A, &HC6, &HC 
&H3D, &HEB, &HE4 , &HE7 
&HE4 , &HB6, &H3F, &H49 
&HC6, 6&H3 , &H3D, &HEB 
$HED, &HCB, &H89, &SHF7 
SH3F, &H49 , &H20, &H29 
SHBG , &H3F, &H4C, &HC6 
&H69 , &H3D, &H34, &H4 
SHBG , &H3F, &H4B, &HC6 
&H18, &H3D, &HEB, &HE4 
&HE7 , SHE4 , &HB6 , &H3F 
&H4A, SHC6,&H6 , &H3D 
&HEB, &HE4 , &HE7, &HE4 
SHBG , &H3F, &H49 , &HC6 
&H1 , &H3D, &HEB, &HEZ 
&HCB, &H89, &HF7, &H3F 
&H49, &SHF6, &H3E, &H2 
&H58 , SHFB, &H3E, &H3 
SHIF, &H1 , &HB6, &H3F 
$&H49 , SHBD, &H3F, &H36 
&H39, SH1F, &H26, &HF6 
SHBG , &H3F, &H46, &H34 
&H2 , &HB6, &H3F, &H43 
&HAB, &HED, &HB7, &H3F 
&H43, &H16, &H2C, &HFF 
&H17 , &SH7C, &H3F, &H42 
&HB6 , &H3F, &H42, &H81 
&H29, &H10, &H26, &SHFF 
&H6 ,&H86,&HD ,&HBD 
&H3F, &H36, &HB6, &H3F 
&H48,6&H84,&H1 ,&HBB 
$H3F, &H45, &H8B, &H3 
&HB7 , &H3F, &H45, &H7C 


1000 DATA 
1616 DATA 
1929 DATA 
1639 DATA 
1649 DATA 
1059 DATA 
1968 DATA 
1676 DATA 
1986 DATA 


October 1986 Aust 


&H3F , &H48 , &H81, &HCZ 
&H19 , &H26, &HFE, &HE7 
&H86, SHE, &SHBD, &H3F 
&H36 , &H39, &HC6, SHFE 
&HD7, &H6F, SHAD, &HOF 
&HAG,&H2 ,&H4F, &H97 
&HOC, &H39, SHS , &H2 
SHS ,&HP ,&HD , &HP 
&HZ ,&HP 
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Good Times with OS-9 
on the Hard Disk 


By Dale L. Puckett 


Rainbow Contributing Editor 





especially as I start to write this edition 

of KISSable OS-9 during the last week 
of May. Yet, it’s almost harder to believe I 
have 576K of RAM in my Color Computer 
with another 256K waiting to be installed, 
while I sit here playing with the new 15- 
megabyte hard disk from Tandy. This month 
we'll share some ideas about organizing 
massive amounts of data on a hard disk, and 
work through several patches of random- 
ness as we try to answer some of the ques- 
tions you’ve posed during the past few 
months. 

I try to take my marching orders from you 
— that’s why we attempt to answer at least 
a few questions each month. If you have a 
question, please send it to us and we'll share 
it with everyone. And don’t forget, if you 
have any good ideas or tips you would like 
to share with fellow OS-9 users send them 
to us here at “KISSable OS-9” and we'll sure 
try to get them in print. The same goes for 
short procedures and program listings. 
Some of the ideas you have sent in the past 


I: hard to believe it’s almost fall — 





Dale L. Puckett, who is author of The 
Official BASICO9 Tour Guide and co- 
author, with Peter Dibble, of The Official 
Rainbow Guide to OS-9, is a free-lance 
writer and programmer. He serves as 
director-at-large of the OS-9 Users Group 
and is a member of the Computer Press 
Association. Dale works as a U.S. Coast 
Guard chief warrant officer and lives in 
Alexandria, Virginia. 
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have been clever enough to impress a lot of 
veteran OS-9 programmers. Keep up the 
good work. 

Fate is often unpredictable. Less than a 
week after Fran McGee loaned me one of the 
new Tandy !5-megabyte hard disk drives 
and a new hard disk controller cartridge, my 
old gray CoCo bit the dust. To solve the 
problem we rushed out and bought a CoCo 
2 with a matching white Multi-Pak Interface 
and went to work. 

Installation of the Tandy hard disk drive 
is very easy. To use it, you need a Color 
Computer with 64K of memory, a Multi- 
Pak Interface, at least one floppy disk drive 
and controller, the Color Computer Hard 
Disk Controller, Version 2.00.00 of the OS- 
9 operating system and the hard disk drive 
itself. 

After making sure the Color Computer 
and Multi-Pak Interface are turned off, plug 
the Hard Disk Controller into slot 3 of the 
Multi-Pak Interface. This is the second slot 
from the back. The floppy disk controller 
stays in slot 4. The two controllers must be 
in their assigned slots because the OS-9 
floppy and hard disk drivers have been 
programmed to find them there. If you 
change slots, the drives will not work. 

After you have plugged in the cartridges, 
connect the 50-pin ribbon cable from the 
hard disk controller cartridge to the hard 
disk drive. The ribbon cable must exit 
toward the rear of the Multi-Pak Interface 
— or toward the side of the Hard Disk 
Controller with the label. After the cable is 
installed, turn on the Multi-Pak, the Color 
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Computer and the floppy and hard disk 
drives, in that order. 

When turning on the hard disk drive for 
the first time you will not find any informa- 
tion on it. It must be formatted before you 
can use it to store OS-9 programs and data. 
To do this, first load the /hO device descrip- 
tor and the hard disk driver modules. Both 
are stored in the modules directory of the 
boot/config disk supplied with OS-9 Ver- 
sion 2.00.00. The descriptor is stored in a file 
named hO—15.dd and the driver is stored in 
CCHDisk.dr. After these modules are 
loaded use the standard OS-9 format utility 
command to initialize the hard disk drive. 

Once you have formatted the hard disk, 
you will probably want to use the Config 
program to make a new OS-9 boot file that 
contains /hO and CCHDisk. After you do 
this, OS-9 will boot from the floppy contain- 
ing the OS-9 boot file, but it will start up 
with the current execution directory and 
current data directory set to /h0/cmds and 
/hO. It’s amazing! 

This drive is almost as fast as a RAM disk. 
After you install a hard disk drive, OS-9 
becomes a whole new ball game. However, 
if you use a number of application programs 
on the Color Computer that need a lot of 
memory, be very careful about the number 
of modules you load into the OS-9 boot file. 
To use the C compiler, for example, you 
must strip OS-9 boot down to the bare 
minimum. You can’t remove the floppy disk 
drivers, but you can get rid of the printer 
descriptor, /p, and the related driver, 
Printer, and a few other modules. If you use 
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a RAM disk in addition to the hard disk you 
will really find memory space full — but it’s 
worth it. 

Your approach to computing will defi- 
nitely change when you get a hard disk, and 
your enjoyment level will soar. You will 
eventually need to get organized, however. 
If you don’t, you'll soon be lost in a sea of 
directories and subdirectories. 

I was asked an unusual question at RAIN- 
BOWfest Chicago. “How should I set up my 
disk directories? Is it best to use a tall skinny 
directory structure or should I spread them 
out in a horizontal fashion?” 

Organizing a disk is a personal matter but 
perhaps we can help with an overview of the 
possibilities available when using OS-9. To 
start, remember it was a tall skinny directory 
structure you were forced into when using 
Disk BASIC, CP/M, Flex or even the first 
several versions of MS-DOS on an IBM PC. 
Now remember the long lists you had to 
search when finding a stray file. It took 
forever, didn’t it? Let’s move forward and 
show how you can use OS-9’s hierarchical 
file system to get organized. 

The most basic element in the OS-9 filing 
system is the individual file. Files most often 
contain data you are interested in — the text 
processing documents holding letters you 
have written or spreadsheets showing a 
profit and loss statement, for example. But, 
OS-9 files can also contain directories to tell 
the system how to find other information, 
or even the programs needed to manipulate 
information. 

To get a handle on the OS-9 filing system, 
think of each mounted disk as a large filing 
cabinet. Inside that filing cabinet, each of the 
directories at the first level can be compared 
to a number of individual drawers. Other 
directories stored in these first level directo- 
ries are called subdirectories. You can liken 
them to file folders. And finally, the individ- 
ual files containing your data can be com- 
pared to the individual pieces of paper 
stored in a file folder. 

The top level of the OS-9 filing system on 
any particular disk is the root directory of 
that disk. The directories stored in the root 
directory usually give a user access to 
application programs and other system data 
he may need. For example, the standard 
system disk with the OS-9 operating system 
from Tandy contains two files and three 
individual directories. The two files, OS-9 
boot and startup, are used to start the 
system. The three directories hold programs 
and other information about the computer. 
The cmds directory contains all of the utility 
command programs to maintain data files. 
The DEFS file contains symbolic definitions 
of all key memory addresses used by the OS- 
9 operating system. And finally, the SYS 
directory contains information OS-9 uses 
occasionally. Included is a message of the 
day which is sent to every new user signing 
on the system and a password file that 
ensures only authorized users have access to 
the system. 

On a multi-user, OS-9 based computer the 
system manager often sets up a directory for 
each user. These user directories are usually 


placed in the root directory of the disk. It 
is then up to the individual user to organize 
the data in his own directory. Since you are 
the user, the system manager’s move places 
the ball squarely in your court. Let’s look at 
one way to play the game. 

First, we'll assume you don’t have a hard 
disk. Set up directories to match the many 
jobs you have to do. For example, if you 
supervise a large staff, do the billing, track 
an inventory and keep an eye on the sales 
team, you will want to set up at least four 
directories in the root directory of your 
personal disk. The first few levels of the 
filing system might look something like this: 





In the directory named Billing, you could 
create two sub-directories or folders — Sent 
and Received. In Inventory you might want 
to set up folders for Completed Widgets and 
Spare Parts. In the Personnel directory you 
will need at least two folders — one for 
Evaluations and another for Payroll. And 
finally, in the Sales folder you can create 12 
folders or sub-directories, one for each 
month. Each of these folders would hold 
files containing each sales person’s report for 
the month plus any charts or graphics 
needed to make a clear report to the boss. 

If you are the only user and set up a filing 
system on your own disk, the structure of the 
disk would be similar to that in the figure 
above. If you are working in an office with 
two other managers and using a hard disk 
for storage, the system manager will most 
likely have created three directories — one 
for each of you in the root directory of the 
hard disk. In that case, simply move your 
top directory level to the hard disk from 
your floppy disk. 

If your name is Fred and one of the three 
user directories set up by the system man- 
ager is named Fred, then the pathlist to your 
Billing folder would become /h0/fred/ 
billing. 

And, the complete pathlist to Jim's sales 
report for January would be: 


/hO/fred/sales/january/jim. 


It is easy to find a particular file after 
setting up a logical filing system similar to 


the one above. For example, if you need to 
check out Joe’s last personnel evaulation, 
you need to look in a file with a pathlist like 
this: 


| dO/fred/ personnel/evaluations/ 
february/sam 


It’s easy to find a file when it is stored in 
a logical place. Typing a long pathlist like 
this can get old fast, but since you most likely 
work on all of your personnel reports at the 
same time, you can take advantage of one 
of OS-9’s handy features and set the current 
data directory to the current month’s reports 
with this command line: 


OS9: chd /d0/fred/personnel/ 
evaluations/feb 


Then, all you need to type is: 
O59: List Sam 


The first command line above sets the 
current data directory to: 


/d0/fred/personnel/evaluations/feb. 


All of these directories contain files 
holding data. And since you know your 
business better than anyone else, OS-9 lets 
you organize data directories the way you 
have organized your business. After this, 
you will be able to find files quickly. And, 
once your disk is organized, OS-9’s chd 
command makes it easy to change the 
current data directory to any particular set 
of files. 


OS-9 Helps Organize Programs Too 

OS-9 files can also contain programs; its 
designers moved one up on UNIX and 
added a second current directory. This 
second working directory is called the 
current execution directory. It is used to hold 
files containing 6809 object code and inter- 
mediate code from one of the many OS-9 
languages that can be run on your computer. 

When booting OS-9 on the Color Com- 
puter on a floppy disk system, a program 
called sysgo is executed automatically and 
one of the first things it does is set up your 
current directories. After sysgo runs, the 
current execution directory will be /d0/ 
cmds and your current data directory will be 
/ dO. 

The “current” directories apply only to the 
disk mounted in the drive /dO when you 
boot the system. If you remove that disk and 
insert another, the system records are no 
longer “current.” You must use the OS-9 chd 
(change current data directory) and chx 
(change current execution directory) utility 
commands before trying to do any work 
with the new disk. If you don’t do this, the 
system gets lost because it will look for the 
directories on the new disk at the same 
location where it found them on the old disk. 
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When it doesn’t find them there and loads 
something inappropriate into memory, 
strange things often happen. 

By the way, if you own a Tandy hard disk 
and have installed its device descriptor, /h0, 
and its device driver, CCHDISK, in your 
OS-9 boot file, the sysgo program in OS-9 
Version 2.00.00 automatically sets the cur- 
rent execution directory to /h0/cmds and 
the current data directory to /h0 each time 
you start the system. 

If you decide to run a program, Dir for 
example, OS-9 looks for Dir and then runs 
it. However, before OS-9 looks on the disk 
drives, it checks to see if the program 1s 
already in memory. To do this it looks for 
the name typed on the command line in its 
module directory. If OS-9 finds Dir in its 
module directory, it links to it and runs it 
immediately. No disk access is needed. 

But what happens if Dir is not in memory? 
OS-9 looks in the current execution direc- 
tory and tries to find a file named Dir. If it 
finds a file with the right name in this 
directory, it assumes it is executable code, 
loads it into memory and runs it. 

And finally, if OS-9 doesn’t find Dir, in 
the current execution directory it makes one 
more try — this time in the current data 
directory. But, if OS-9 finds Dir in the 
current data directory it won't treat it like 
a program. It treats it like a data file. More 
specifically, it assumes this data file contains 
a procedure file. 


An OS-9 procedure file is similar to a 
UNIX script file. A procedure file contains 
a list of OS-9 commands which are read into 
the shell. Each time a command line is read, 
it is run just as if vou had typed it. The 
process continues until OS-9 receives an end 
of file signal from the procedure file. 


In the case of the intermediate code from 
OS-9 languages, execution of the language's 
run time package ts also automatic. Packed 
BASICOI programs, for example, are exe- 
cuted by arun time interpreter named Runb. 
When you type the name of a file stored in 
the current execution directory containing 
packed BASIC09 code, OS-9 loads this i-code 
into memory just like it were 6809 object 
code. 


However, before OS-9 runs the code in 
any module it checks the information in the 
module header to find out what type of code 
isin the module. When it finds out you have 
loaded packed BASIC09 1-code, it knows that 
Runb is needed to run the program. So, OS- 
9 automatically loads Runb and executes it 
with the name of the module as a parameter. 
All of this work ts transparent and all you 
sce on the screen is the output of the BASICO9 
program. 


When you first purchase Tandy’s version 
of OS-9 there are enough utility command 
files stored in the directory /d0/cmds on the 
OS-9 system master to fill several screen 
pages when you list the filenames. After you 
have added a few dozen of your own favorite 
application programs and third party utility 
command packages, it becomes almost 
impossible to find a file in a directory listing 


on the screen. The problem is complicated 
by the fact that the Dir utility command in 
the 6809 version of OS-9 does not alphabet- 
ize the directory listing for you. The new 68K 
version of OS-9 lists the contents of the 
directories in alphabetical order. 

So, if you use a hard disk and own 
hundreds of programs, you need to organize 
a set of directories on the hard disk using a 
method similar to the one for organizing 
your data directories. 

For example, to keep current I try to take 
a look at most all OS-9 software. Many of 
the third party utility packages contain 
similar programs and more than one devel- 
Oper may use the same name. The standard 
UNIX-like utilities, /s and mv are good 
examples. 

But, there's a hitch. While all of these 
utilities may have the same name, they 
require a different syntax on the command 
line. Also, you can't have more than one 
program stored with the same filename in 
the same directory. 

While I was exercising the Tandy 15 
megabyte hard disk, I decided to organize 
my utility programs. I did this by creating 
subdirectories in the current execution 
directory, /hO0/cmds. For typing ease I used 
two or three letter names for the directories 
to store programs and utilities from the 
various third party vendors. Here is a look 
at the program side of my filing system. 


/HO/CMDS 
CW DPJ FHL MW RS SG 


Computerware’s utilities are stored in the 
directory, CW; D. P. Johnson's hackers kits 
and utility packages live in DPJ; products 
from Frank Hogg Laboratory are stored in 
FHL; Microware’s toolkit is saved in MW; 
Tandy products live in RS and finally Steve 
Goldberg's Utilipak programs are run from 
SG. 

Using the standard OS-9 shell from the 
Tandy release of OS-9, I must type the 
complete pathlist to a utility in one of these 
directories. That's why I used the short 
directory names. For example, if I want to 
run Steve Goldberg's version of /s, | merely 
type: 


059: sg’ls 


If I wanted to use Brian Lantz’s verison 
of /s from Computerware, I would have 
typed: 


OS9: cwls 


But, by using the new kshell in the Ad- 
vanced Utilities package from Computer- 
ware, | make this operation automatic, 
going as far as to tell OS-9 which vendors 
command I want to have priority. To do this 
I use the new path command built into 
kshell. 


O59: path=cw:sg:mu:dp):fhi:rs 


After typing this command line, I receive 
very few “Error #216 Program Not Found” 


errors. The kshell first searches /h0/cmds 
for the filename typed. If it doesn’t find it 
there, it looks in the subdirectories, CW, SG, 
MW, DPJ, FHL and RS in that order. It 
runs the first program stored in a file with 
the name I have typed. In other words, if the 
CW subdirectory contains an /s command, 
the /s in the DPJ directory will never be run 
as long as this path definition is active. 
However, I could always select it manually 
and override the default path by typing: 


0S9: dpj/7ls 


While getting the hard disk organized you 
will sometimes move a lot of files back and 
forth from one directory to another. The 
DirCopy utility from Computerware’s Disk 
Fix and Utilities package is almost indispen- 
sable during this process. Use a command 
like this: 

OS9: dircopy /HO/FIRST DIREC 

TORY /HO/SECOND DIRECTORY 


DirCopy can be told to let you confirm 
each copy command. This means you can 
select the files you want to copy from one 
directory to another on the fly. You can also 
tell the program to copy files stored in 
subdirectories while it is copying a directory, 
and this feature is really handy — tell it to 
place the files in the new directory in 
alphabetical order while it is being created. 

You can also tell Dircopy to automatically 
rewrite any file in the destination directory 
with the same name as a file in the source 
directory. However, if you don't feel safe 
with this approach, have Dircopy ask you 
each time it discovers this problem. 

Ask 100 people how they organize their 
hard disk and you'll get 100 different 
answers. But there are some basics you 
should consider. To get in the mood, study 
these approaches from two members of the 
OS-9 SIG. 


1. /HO/LANGUAGES/BASICO9 


/SOURCE/ INVENTORY /PROGRAMS 
2. /HO/INVENTORY/PROGRAMS 


/SOURCE/BASICO9 

What is more important — the job or the 
program that runs the program that does the 
job? The first example emphasizes the 
computer instead of the job. The latter takes 
the opposite approach. I really can't say it 
any better than Kevin Darling who is one of 
the most active and knowledgeable individ- 
uals on the OS-9 SIG. 

“The fact that a file is ‘inventory related’ 
is much more important to me than the 
language,” he said. In other words, some 
nouns are more important to me than their 
adjectives.” 

Darling also posed a very relevant ques- 
tion. “Could someone other than you find 
things quickly when everything is stored 
relative to the language it is written in? I 
would hate to go looking all over my differ- 
ent language subdirectories, just to find one 
of my inventory programs.” 

Other good ideas came from Pete Lyall 
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and Jonathan Cluts who help SysOp Wayne 
Day manage the SIG. “I think we need to 
standardize and use a number of common 
directories like the UNIX crowd,” Lyall 
said. “If we do this, then program authors 
can make certain assumptions about direc- 
tories in this set.” 

Lyall’s proposed directory set includes 
cmds, defs, etc, help, lib, src, sys, tmp and 
user. We are already familiar with cmds, defs 
and sys; they come predefined with OS-9. 
The purpose of the help directory is obvious, 
as is src. User would be used for all logins 
and would contain subdirectories for indi- 


programmers to take advantage of OS-9’s 
anonymous filenames. In other words, 
instead of coding a pathlist named “/d0/ 
spell/common.dat,” I should have made 
that pathlist read, “. . ./spell/common.dat.” 

The first period tells OS-9 to look for the 
file in the current data directory, two periods 
means look at the parent directory of the 
current data directory and three periods 
means look in the parent.of the parent of the 
current data directory. Is that the grandpar- 
ent directory? By including five or six of 
these periods, I could have forced OS-9 to 
look clear back in the root directory. Then 


“It is also now possible to give the utilities an 
optional command line argument list rather 
than use standard input.” 





vidual users. Etc would be a directory where 
you could store OS-9 procedure files. Li- 
brary files obviously would be stored in the 
lib directory. This might also be a good place 
to put dictionaries and other common files. 
And finally, tmp would be used to store 
temporary work files. 

Cluts’ idea has to do with starting the 
system. “I run fsmnon at startup so I always 
log in. By logging in as different users, I can 
restrict myself to certain directories on the 
hard disk. This means I can only acciden- 
tally. destroy some of my files. If I stay in the 
root directory I could destroy them all,” he 
said. 

On the same evening Cornelius Seon, who 
frequents RAINBOW’s CoCo SIG on Delphi 
added the most relevant comment about his 
new Tandy hard disk. “Several packages 
which were only marginally useful on flop- 
pies are just wonderful now,” he said. I 
agree. 

But before closing, he left everyone with 
a problem. “There is a problem with Mother 
Tandy’s Godfrey Daniels’ helpfulness,” he 
said. “I’m finding many programs they 
either wrote or commissioned looking for 
data on floppy drive /dO after I’ve already 
transferred everything to /h0 using identical 
directory names.” 

Maybe we can help here. The problem 
probably isn’t Tandy’s at all. It relates more 
to the fast pace at which hardware technol- 
ogy is racing past the software. When most 
of the guilty programs were written, hard 
disks didn’t even exist. If early software 
designers had made one change, programs 
would have moved right over from /d0 to 
/hO automatically. We print that change here 
so anyone developing software now can 
avoid our earlier mistake. 

Most of the programs causing a problem 
contain a pathlist to a device and directory. 
Desk Mate is a good example. DynaSpell is 
another. For example, when DynaSpell 
needs the dictionary, it looks for /d0/spell/ 
dictionary.dat. The future solution is for the 


it wouldn't have mattered whether I had the 
file stored on /dO or /h0, because it would 
be anonymous. I guess we all learn sometime 
— better late than never! 

The fix for programs already written is to 
change the ‘D’ in the offending pathlists to 
an ‘H’ or to change the ‘“/d0” to “...” 
Sounds easy enough, but how do you go 
about it? 

There are several approaches. First, in 
many of the programs the strings defining 
the pathlist are located early in the program 
and you can locate them easily with the OS- 
9 dump utility. For example if you need to 
find these strings in DynaSpell, you would 
type: 


OS9: dump spell 


In the first page of the Hex dump you will 
see the strings and can jot down the number 
of bytes that each ‘D’ is offset from the 
beginning of the module. After you do this, 
load the program: 


OS3: load spell 


Then, call up the OS-9 Debug utility and 
link to spell. 


OS9: debug 
db: | spell 


Now, move the Debug pointer to the first 
*‘D’ and use the ‘=’ command to change it to 
an ‘H’. After you change all the /d0s to 
/hOs and quit Débug with its Q command, 
you can save the file into a tempory file. 


OS93: save tempspel! spell 


You're almost home free now. Rename or 
delete the original spell file and run this 
command. 


OS9: verify <tempspell>spell u 


Don’t forget the ‘u’, it tells the OS-9 verify 
utility command to update the CRC of the 
module in the file you are verifying. After 
you have done this you can load or run the 
new spell file. Even though we used the 
DynaSpell program as an example here, 
keep in mind this same technique can be 
used with any program you need to modify 
for operation with a hard disk. 

If you purchased Computerware’s Disk 
Fix and Utilities, you will find it much easier 
to use the Patch utility from that package. 
For example, to make this change you first 


type: 
OS93: patch spell 


Then uses Patch’s ‘D’ — for display — 
command to find the strings defining the 
bothersome pathlists. 


>D 0002 


Again, jot down the location of the 
offending ‘D’ and type: 


>M @OXX 


The XX would be replaced by the offset 
that you jotted down above. At this point 
when you see patch display the ‘D’ (as 44, 
by the way) you can type: 


>°H 
>s 


Go through this sequence for each of the 
pathlists that contain /d0. Then, type: 


>V 


The V command tells Patch to validate the 
cre of the file you have patched and correct 
it. After you have done this, you can exit 
Patch with its Q command. 

Sometimes the strings containing the 
floppy based pathlists aren’t stored in the 
first page. In this case Patch is really a help 
because it gives you a find command. After 
starting Patch you can type: 


>F ’DO 


After you press the ENTER key, Patch 
prints a list of every occurrence of that string 
in the program you are adapting to the hard 
disk. After you have the list of addresses, 
you must use the M command again to 
change the ‘D’ to an ‘H’ in each case. One 
note of caution. Take a close look at each 
‘dO’ you find and make sure that it is, in fact, 
part of an actual pathlist. It could just be a 
natural occurrence in the program’s code 
itself. 


Dan Johnson Markets Enhanced Package 
SDisk author Dan Johnson (7655 SW 

Cedarcrest St., Portland, OR 97223, 503- 

244-8152) has upgraded all of his OS-9 filter 
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and hacker’s kits and placed them in one 
package called the L/ Utility Pak. Don’t let 
the name fool you; all but three of the 
programs in this package run on both Level 
I and Level II OS-9 systems. These three deal 
with absolute memory manipulations. 

Johnson hopes to release a supplement 
Level II utility package sometime later. I bet 
he'll have an incentive when Tandy’s new 
Color Computer hits the market. He has 
also added several new programs to the 
package including Modbuster, Afmt, Upall, 
Grep and Sectedit. 

Dan has made major improvements to the 
template matching algorithm in his new Is 
command and most of the utilities now 
accept options at the beginning or end of a 
command line. It is also now possible to give 
the utilities an optional command line 
argument list rather than use standard input. 
The MacGen program has been expanded 
and Johnson gives the MacGen source for 
a useful program, UpAll. The package sells 
for $49.95 and is shipped on a CoCo format- 
ted OS-9 disk. ‘However, you can buy the 
package in other formats by paying an 
additional $2. Johnson calls it a deal as good 
as Turbo PASCAL on MS-DOS. 


Two More Goldberg Tips 

Earlier this year, Steve Goldberg discov- 
ered that the modification date was changed 
every time he changed directories while 
using OS-9 Version 2.00.00. To solve the 
problem, he uses the following procedure 
file on the shell module and builds a new 
boot file with the patched shell. 


debug 

1 <SPACEBAR> shell 
. <SPACEBAR> .+269 
=61 

- <SPACEBAR> .+28D 
=£9 

=49 

=67 


q 
cobbler “d@ 


Goldberg noted that since he has run this 
procedure his directory changes are faster 


and the drives don’t grind while attempting 
to write the date to a write protected disk 
when he changes directories. 

I thought we published the changes to 
CCDisk which let you step your disk drives 
at a faster rate earlier this year. But I couldn’t 
find them, and we have been seeing a lot of 
traffic on the Delphi CoCo SIG and getting 
a few requests in the mail, so we'll give it 
another try. This time, thanks to Steve 
Goldberg’s homework, we'll compare them 
to the identical changes you had to make 
with OS-9 Version 1.00 and 1.01. The new 
values change the step rate of your drives to 
six milliseconds. See The Complete Rain- 
bow Guide to OS-9 for the value for other 
step rates. 


CCDISK OFFSETS 


Version 1.0 Version 2.0 New Value 
SIFE SIF9 $10 
$204 SIFF $08 
$205 $200 $8B 
$2DD $2DD $40 
$2E9 $2E8 $00 


Goldberg is brave and pushed the value 
of the word at $1FF down to $0001. I don’t 
think I would push it that far. He also cut 
the drive startup delay since his drives 
seemed to be fast. To do this he changed the 
SAO at an offset of $2F9 to SOA. 


BASIC09 Beginners Notes 

Henry J. Proffitt of Haley Station, Ontar- 
io wrote to ask how he could enter a short 
BASICO9 program he had stored in a standard 
OS-9 text file into BASICO9. Proffitt entered 
the program with the Build utility, but you 
could use any OS-9 editor including TS Edit 
or the Desk Mate editor to enter a BASICO9 
program. 

The thing you must remember is that 
BASICO9 expects to see the word “procedure” 
as the first thing in a file it is trying to load. 
Therefore, if you type the line procedure 
myprogram as the first line in your file, 
BASICO9 will be able to load it. Incidentally, 
the ‘p’ in procedure must be the very first 
character in the file. 


After you have created the text file follow- 
ing the directions above, you can load it 
from the BASICO9 system mode — you'll 
know you are there because BASICO9 prompts 
with “B:”. Just type: 


B: load myprogram 


BASICO9 assumes there is a file named 
“myprogram” stored in your current data 
directory and that the file contains a BASICO9 
procedure. If you have not saved your 
program there, use the CHD command from 
within BASICO9 to set the current data direc- 
tory or type a complete pathlist: 


B: load “D1/“MYDIRECTORY~ 
MYPROGRAM 


We received a note from Robert Gault of 
Grosse Pointe Woods, Michigan about a 
solution to another BASICO9 programming 
problem you may have noticed while work- 
ing with BASICO9. How do you send a char- 
acter with the value $FF to the screen or 
printer? This is a problem that must be 
solved if you plan on sending graphics to the 
printer. 

There are two solutions. You can use the 
BASICO9 shell command and use OS-9 to send 
out the character or you can use a PUT 
statement instead of a PRINT statement. 


SHELL “display FF” 
SHELL “display FF >/p” 
PUT 8PRINTER, SFF 


Gault submitted a demonstation proce- 
dure and a rough and ready screen dump 
program to illustrate his techniques. 


Next Month 

Next month we'll dig back in the mailbox 
and see what’s been bothering you the most. 
Hopefully, we can come up with atip or two. 
And, we'll cross our fingers and hope we get 
to play with a new OS-9 Level II Color 
Computer soon! Til then, keep on hack- 
ing! 








DATALOG 


SOFTWARE SPECIAUSTS Perfect Brand Disks. 


5.25" (Box of 10) 

SSDD .............. Calll! 
DSDD .............. $27.00 
DSOD ...........6 $63.00 
DSHD (1.2MB) ..... $90.00 
3.5" (Box of 6) 

SSDD .............. $28.50 
DSDD .............. $45.00 


Unit 2, 278 Newmarket Rd., Wilston, Qld. 4051. 
07—300—5463 07—300—1978 


Presenting 
the DTX 2001 Monitor. 
$460.00 + Tax (20%) 


* Sharp brilliant colour 
* Green and Amber modes 
* NSTC input 


* Sound 
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Listing 1: strings 


PROCEDURE strings . 
DIM ss:STRING[256] 
DIM i,memory: INTEGER 


memory :=ADDR(ss) 


(* Now f111 memory with $FF's *) 
FOR i=memory TO memory+255 

POKE 1,255 

NEXT i 


(* Note that BASICO9 thinks ss is an empty string *) 


PRINT "The length of string ss ="; LEN(ss) 

PRINT “ss =("; ss; ")" 

PRINT "Now we will PUT ss. Note the difference!" 
PUT #1,ss 


(* Use these lines to send ss to a printer, then *) 
(* OPEN #printer, "/p" *) 


Listing 2: printer 


PROCEDURE printer 
(* This procedure is a rough and ready graphics screen dump *) 


(* It assumes a preceding graphics program has used *) 
(* GFX("mode" , format ,color) *) 
(* If your printer uses an eight pin graphics format change *) 
(* the "pin" loop to 0 to 7. * ( 


DIM dev: BYTE 


DIM color,x,y,pin,send, location: INTEGER 
DIM code: BYTE 


OPEN #dev,"/p":WRITE 

(* Now set printer to graphics mode *) 
PRINT #dev,CHRS$(18) 

location: -ADDR(code) 


FOR y=191 TO 7 STEP -7 
FOR x=0 TO 255 


(* tell printer code is graphics *) 
send:=128 


FOR pin=0 TO 6 

(* Test Pixel *) 

RUN gfx("gcolr",x,y-pin,color) 

(* Printer used has top pin 2“0 bottom pin 2*6 *) 
send: =LOR(send,MOD(color,2)*2**pin) 

NEXT pin 

POKE location+x, send 

NEXT x 

PUT #dev,code 

(* Send carriage return *) 

PRINT #dev,CHR$ (SOD) 

NEXT y fv 
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WHAT’S ON THE BEST OF CoCoOQZ 





Best of Co CoCoOz #1. EDUCATION 


ROADQUIZ ........... 000 0ee WEBB 
HANGMAN occ c cece cenes aLepn DELTA 
AUSTGEOG .............05:. P. THOMAS 
SPELL ...... cc eee eee ee ees IAN LOBLEY 
FRACTUT .........08. ROBBIE DALZELL 
ICOSA LL. ccc wee eeee BOB WALTERS 
TAXMAN ...... ccc cee eee TONY PARFITT 
MARKET ...........0008- ALEPH DELTA 
TOWNQUIZ ..............2.. ROB WEBB 
ALFABETA ................. RON WEBB 
TANK ADDITION ....... DEAN HODGSON 
TABLES ............. BARRIE GERRAND 
KIDSTUFF ............ JOHANNA VAGG 
FLAGQUIZ .......... 000 c ee ROB WEBB 
Best of CoCoOz #2 part 1. 16K GAMES. 
LE-PAS ..... ccc cc cee Wrongsoft 
COCOMIND .......... STEVE COLEMAN 
OILSLICK ............... JEREMY GANS 
CCMETEOR ............ BOB THOMSON 
BATTACK ...........0.08- JEREMY GANS 
PROBDICE ........... BOB DELBOURGO 
CHECKERS ................ J&JGANS 
PYTHON .. ccc ce eee tenes 
POKERMCH..... GRAHAM & MATTHEWS 
SPEEDMATH.......... DEAN HODGSON 
LNDATTCK........ ALDO DEBERNARDIS 
INVADERS ............ DEAN HODGSON 
RALLY .................. TONY PARFITT 
FOURDRAW ........... JOHANNA VAGG 
Next: 


Best of CoCoOz #5. Adventure Games 
Best of CoCoOz #6. Preschool Education 


Best of CoCoOz #2 part 2. 32K GAMES. 


TREASURE ........... DAVISON & GANS 
MASTERMIND ....... GRAHAM JORDAN 
ANESTHESIA ............ MIKE MARTYN 
OREGONTRAIL ....... DEAN HODGSON 
ADVENTURE .......... STUART RAYNER 
SHOOTING GALLERY ..... TOM DYKEMA 
GARDEN ............ DAVE BLUHDORN 
YAHTZEE ............... KEVIN GOWAN 
BATTLESHIP .......... CHARIS SIMPSON 
ANDROMIDA .......... MAX BETTRIDGE 


Best of CoCoOz #3. UTILITIES. 
PAGER 


HI oo... cece eee eees ALEX. HARTMANN 
SPOOL64K ........... WARREN WARNE 
CREATITL ........... BRIAN FERGUSON 
FASTEXT 0... ccc ccee cee ce ec eee OZ-WiZ 
DATAGEN .............. ROBIN BROWN 
SPEEDCTR ......... PAUL HUMPHREYS 
PRNTSORT ......... PAUL HUMPHREYS 
BIGREMS ..........0.....00005: BOBT 
DIR... .. cece eee PAUL HUMPHREYS 
COPYDIR ........... THOMAS SZULCHA 
LABELLER ................05- J.D. RAY 
SCRPAT ...........00.005 TOM DYKEMA 
MONITOR+ ......... BRIAN FERGUSON 
BEAUTY ........ ccc cece eee ees BOBT 
PCOPY .........0.ce cee e eee B. DOUGAN 
RAMTEST .............. TOM DYKLEMA 
DISKFILE ..............004, B. DOUGAN 
LABEL .............0005. F. BISSELING 


> RESTACC 


Best of CoCoOz #4. BUSINESS 
HI ALEX. HARTMANN 
(Disk Directory manager) 
BANKSTAT ............ 
(Statement annal & store) 
INSURE ROY VANDERSTEEN 
(Analyse home contents) 

WARREN WARNE 


SPOOL64K ........... 
oe spooler req 64K) 

2BC WARREN WARNE 
(Hold 2 sep progs in mem) 


DATABASE ......... PAUL HUMPHREYS 
(THE tape database) 


BARRY HATTAM 


(Tape restruant accounts) 

PASPDSHT ....... GRAHAM MORPHETT 
(Disk print out SPOSHEET) 

PERSMAN pau HUMPHREYS 
(Personal finance management) 

CC5 GRA AHAM MORPHETT 


(Sales Invcicing-tape sys) 
COCOFILE BRIAN DOUGAN 
PAUL HUMPHREYS 
(Disk Program Management Sys) 
4OKGREY RAY GAUVREAU 
(40K Basic for grey 64K CoCo) 


TAXATION 2.0... ccc ccc eens ? 
(Calc tax payable) 

SPDSHEET........ GRAHAM MORPHETT 
(Disk 22 coloum spreadsheet) 

ACSI... eee eee GREG WILSON 


(Multi disk data base) 


PRICES:— TAPE $10/DISK $16 EACH 








BEST OF COCOOZ7 





LIL’COCO THE ROOM BACK ST 
MARTHA BAD MOON MCC 
LOCO COCO ART KANGA 
THE BOAT SAD COCO TOWER 
WINDYDAY SAILING OUTHOUSE 
EAGLE BLASTER FOGHORN 
SMURF SUNSTATE HELICOPT 
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GVA 


My, i, ti, tly tt. btn, ttn tty Ltr Ate Ate thy tty, tty tty thy, Atp 


= 
= 
- 
= 
. 


P.O. BOX 1742, SOUTHPORT. QLD. 4215 


Phone (075) 510 Old 


ORDER FORM 


AUSTRALIAN RAINBOV 12 mnths 
6 mnths 
1 mnth 
AUSTRALIAN CoCo 12 mnths 
6 mnths 
1 mnth 
CoCoOZ on tape i2 mnths 
6 mnths 
1 mth $ 9.50..... 
CoCoOZ on Disk 12 mnths $102.50 ..... 
6 mnths $ 58.00 ..... 
1 mnth $ 10.95 ..... 
MiCo0Z on Tape 12 mnths $ 75.00 ..... 
6 mnths $ 42.00 ..... 
1 mth $ 9,50..... 
RAINBOW ON TAPE (AUST/US) 12 mnths $144.00 ..... 
6 mnths $ 81.00 ..... 
1 mnth $ 15.00..... 
RAINBOW ON DISK (AUST/US) 12 mnths $172.00 ..... 
6 mnths $ 96.75 ..... 
1 mth $ 15.00 ..... 


) 


NW G@ 
NVAIde ONO 
co 
Ol 


HHBAMH DH OH #H 


~~) 


Or charge my credit card monthly TAPE/DISK ONLY 


CoCoOZ on Tape .......eaee Peewee $ 9.50..... 
CoCoOZ on Disk .... . ccc cece nveees $ 10.95 ..... 
MiCoOZ on Tape ..... Peace rere eees $ 9.50 ..... 
Rainbow on Tape (AUST/U.S) ...... $15.00 ..... 
Rainbow on Disk (AUST/U.S) ...... $ 15.00 ..... 


Additional Requirements: 


Sub No: or O New Subscription 


LT Ti tT 
nome] TT ETE TTT TTT TTT 
aawress: [| TE TT TTL TT TT 
TTT TTT TT ee CT 
pnoneo: [TTT ET TT TTT irri 


Please find enclosed CHQ / MONEY ORDER / NO CASH 
Please charge my MASTERCARD / BANKCARD / VISA 


Authorised amount $ .........2. 


Signed : 
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GOLDSOFT 


Hardware & Software for your TANDY computer. 


HARDWARE 
The CoCoConnection: 
Connect your CoCo to the real world and control robots, models, experiments, burglar alarms, water reticulation systems — 
most electrical things. 
Features two MC 6821 PIAs; provides four programmable ports; each port provides eight lines, which can be programmed as 
$206.00 








an input or output; comes complete with tutorial documentation and software; supplied with LED demonstration unit. 
Switchable memory addressing allows use with disk controller or other modules via a multipack interface; plugs into 
Cartridge Slot or Multipack, uses gold plate connectors; a MUST for the hardware designer and debugger! 


Video-Amp: 
Connects simply to your CoCo to drive a Colour or Mono monitor. With instructions $25.00 
With instructions and sound $35.00 


The Probe: 
A temperature measuring device which attaches to the joystick port of your CoCo or $39.95 
T1000, or to the joystick port of your CoCo Max. With amplifier $49.95 












Comes with programs to start you thinking, and is supported monthly in Australian CoCo 
magazine. 


SOFTWARE 









Magazines: | 
Australian Rainbow Magazine — THE magazine for advanced CoCo users! 
Australian CoCo Magazine — THE magazine for the new user of a Tandy computer. 
Also suits owners of CoCos, MC 10s, Tandy 1000s, 100s, 200s & 2000s. 


Back Issues: 
Australian Rainbow Magazine. (Dec ’81 to now.) Please Note: Some months out of stock 
Australian CoCo Magazine. (Aug ’84 to now.) Please Note: Some months out of stock 

CoCoBug Magazine. For CoCo — usually 8 programs in each magazine. (Sep ’84 to Oct 

’85) 

Australian MiCo Magazine. For Tandy MC 10 computers. (Dec ’83 to Jul ’84) 


CoCoOz, on Tape or Disk: 










Australian Rainbow 1986 
1982 — 1985 

Australian CoCo 1986 
Sept 1984 — 1985 

each 

each 































The programs you see listed in Australian CoCo Magazine are available on CoCoOz! Subscrintion 6 months oi 00 
. . _ | | - ] ° 

No laborious typing — just (C)/LOAD and Go! 12 months $75.00 

. Each DISK $10.95 

Back issues of CoCoOz are always available Subscription on disk, 12 months | $102.50 


Rainbow on Tape, or Disk: 
Australian. The programs you see listed in Australian Rainbow Magazine are available on Each Tape $15.00 
tape. A boon if you don’t understand the language! Subscription, 12 months $144.00 
American. We also supply the programs found in American Rainbow on tape. NEW for 1986 ONLY Each DISK $15.00 
Please specify either Australian or American. Subscription on disk, 12 months | $172.00 


MiCoOz: 
The programs in the MiCo section of Australian CoCo Magazine. (For MC 10 computers | Each Tape $9.50 
only) 
Back issues of CoCoOz and MiCoOz are always available 


GOLDDISK 1000 — programs from ‘softgold’ for your Tandy 1000 on disk, and, Pe $10.95 


‘Goldlink 
Goldlink is our very special service on Viatel 642# which you can access with a 
1200/75 Baud modem and the appropriate software. Subscription 
Goldlink may be accessed at nocharge, but access to our BBS on Goldlink costs 15/30c 12 months 
each time or $36.00 annually. Later we will also provide software for you to download, 
and members will be able to obtain this at no further charge or at reduced charges. 








Books: 
HELP: A quick reference guide for CoCo users. 
BYTE: Guide for new CoCo users. 
MiCo HELP: A quick reference for owners of MC 10 computers. 









Bric a Brac: 
Blank tapes .. . 12 for $18.00 or $1.70 each. 
Cassette cases....... 12 tor $3.50 

Disks ... (they work!) . . $2.50 each or $25.00 per box of 10. 


HOW TO ORDER 













Option 1: Use the subscription form in this magazine. 
Option 2: Phone and have ready your Bankcard, Mastercard or Visa number. 

Option 3: Leave an order on Viatel, but be sure to include your Name, Address, Phone Number, Credit 

Card Number and a clear indication of what you require, plus the amount of money you are authorising us to bill you. 
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ACT: 
CANBERRA NTH 
CANBERRA STH 





JOHN BURGER 


062 58 3924 


LES THURBOW 062 88 9226 


ser Group Contacts 






BUNDABERG RON SIMPKIN C/O TANDY 
CAIRNS GLEN HODGES 070 54 6583 
DALBY ANDREW B. SIMPSON 074.62. 3228 
GLADSTONE CAROL CATHCART 079 78 3594 


NSW: GOLD COAST GRAHAM MORPHETT 075 51 0015 
SYDNEY: HERVEY BAY LESLEY HORWOOD 071 22 4989 
BANKSTOWN CARL STERN 02 646 3619 MACKAY LEN MALONEY 079511333x782 
BLACKTOWN KEITH GALLAGHER 02-627-4627 MARYBOROUGH JOHN EFFER 071 21 2651 
CARLINGFORD ROSKO MCKAY 02 624 3353 MT ISA PAUL BOUCKLEY-SIMONS 077 43 6280 
CHATSWOO BILL O'DONNELL 02 419 6081 wURGON PETER ANGEL 071 68 1628 
CLOYTON/ HERMAN FREDRICKSON 02 6236379 ROCKHAMPTON KEIRAN SIMPSON 079 28 6162 
FAIRFIELD ARTH PITTARD 02 72 2881 TARA STEVEN YOUNGBERRY 
GLADESVILLE MARK ROTHWELL 02 817 4627 TOOWOOMBA GRAHAM BURGESS 076 30 4254 
HILLS DIST ARTHUR SLADE 02 622 8940 TOWNSVILLE JOHN O’CALLAGHAN 077 73 2064 
HORNSBY ATHALIE SMART 02 848 8830 YWHITEROCK GLEN HODGES 070 54 6583 
KENTHURST TOM STUART 02 654 2178 : 
LEICHHARDT STEVEN CHICOS 02 560 6207 
or GORGE ECHEGARAY 02 560 9664 
MACQUARIE BIELDS DUGGAN 02-607-3791 NEL AIDE JOHN HAINES 08 278 3560 
BARRY DARNTON 02 618 1909 NORTH STEVEN EISENBERG 08 250 6214 
ROSEVILLE KEN UZZELL 02 467 1619 CREENACRES BETTY LITTLE 08 261 4083 
SUTHERLAND IAN ANNABEL 02 528 330,  MORPHETTVALE KEN RICHARDS 08 384 4503 
SYDNEY EAST JACKY COCKIKOS 02 344 9111. PORT NOARLUNGA ROB DALZELL 08 386 1647 
ALBURY ROK DUNCAN 060 43 103] .SEACOMBE HTS GLENN DAVIS 08 296 7477 
ARMIDALE DOUG BARBER 067 72 7647 PORT LINCOLN BILL BOARDMAN 086 82 2385 
BLAXLAND BRUCE SULLIVAN 047 39 3903 PORT PIRIE VIC KNAUERHASE 086 32 1230 
BROKEN HILL TERRY KOONAN 080 88 2382 WHYALLA MALCOLM PATRICK 086 45 7637 
CAMDEN KEVIN WIETERS 046.66. 8068 
COFFS HARBOUR BOB KENKY 066 51 2205 Tas: 
COOMA ROSS PRATT 0648 23 065 HOBART BOB DELBOURGO 002 25 3896 
COORANBONG GEORGE SAVAGE 049 77 1054 KINGSTON WIM DE PUIT 002 29 4950 
COOTAMUNDRA CHERYL WILLIS 069 42 2264 LAUNCESTON BILL BOWER 003 44 1584 
DENILIQUIN WAYNE PATTERSON 058 81 3014 wyNyARD ANDREW WYLLIE 004 35 1839 
DUBBO GRAEME CLARKE 068 89 2095 
FORBES JOHANNA VAGG 068 52.2943 
GOSFORD PETER SEIFERT 043 32 7874 VIC: | 
GRAFTON PETER LINDSAY 066 42 2503 MELBOURNE: 
GUYRA MICHAEL J. HARTMANN 067 79 7547. MELBOURNE CCC JOY WALLACE 03 277 5182 
JUNEE PAUL MALONEY 069 24 1860  DANDENONG DAVID HORROCKS 03 793 5157 
KEMPSEY RICK FULLER 065-62-7222 DONCASTER JUSTIN LIPTON 03 857 5149 
LEETON BRETT WALLACE 069-53-2081 FRANKSTON BOB HAYTER 03. 783.9748 
LISMORE ROB HILLARD 066 24 3089 NARRE WARREN LEIGH EAMES 03 704 6680 
LITHGOVW DAVID BERGER 063 52 2282 NTH EASTERB PETER WOOD 03 435 2018 
MAITLAND BILL SNOW 049 66 2557 MELTON MARIO GERADA 03 743 1323 
MOREE ALF BATE 067 52 2465 RINGWOOD IVOR DAVIES 03 758 4496 
MUDGEE BRIAN STONE 063-72-1958 SUNBURY JACK SMIT 03.744. 1355 
NAMBUCCA HDS WENDY PETERSON 065 68 6723 BAIRNSDALE COLIN LEHMANN 051 57 1545 
NARROMINE GRAEME CLARKE 068 89 2095 BALLARAT MARK BEVELANDER 053 32 6733 
NEWCASTLE LYE DAWSON 049 49 8144 CHURCHILL GEOFF SPOWART 051 22 1389 
NOVRA ROY LOPEZ 044 48 7031 DAYLESFORD DANNY HEDJI 054 24 8329 
ORANGE JIM JAMES 063 62 8625 EMERALD LEIGH EAMES 059 68 3392 
PARKES DAVID SMALL 068 62 2682 GEELONG DAVID COLLEN 052 43 2128 
PORT MACQUARIE RON LALOR 065 83 8223 HASTINGS MICHEAL MONCK 059 79 2879 
SPRINGWOOD DAVID SEAMONS 047 51 2107 MAFFRA MAX HUCKERBY 051 45 4315 
TAMWORTH ROBERT WEBB 067 65 7256 MOE JIMMY WELSH 051 27 6984 
TAHMOOR GARY SYLVESTER 046 81 9318 MORWELL GEORGE FRANCIS 051 34 5175 
UPPER HUNTER TERRY GRAVOLIN 065 45 1698 SALE BRYAN McHUGH 051 44 4792 
URALLA FRANK MUDFORD 067 78 4391 SHEPPARTON ROSS FARRAR 058 25 1007 
WAGGA WAGGA CES JENKINSON 069 25 2263 SMYTHESDALE TONY ee NEE RRD boy ae eae 
SWAN HILL BARRIE GER 32. 
WIONS JOHN WALLACE 049 90 oste TONGALA TONY HILLIS 058 59 2251 
" arte TSTE get es 2 en 
WONTHAGGI LO 
DARWIN BRENTON PRIOR 089. 81.7766 vORRAWONGA TEN SPONG 057 44 1488 
QLD: 
BRISBANE: WA: 
BIRKDALE COLIN NORTH 07 824 2128 pppry IAN MACLEOD 09 448 2136 
BRASSALL BOB UNSWORTH 07 201 8659 GIRRAWHEEN HANK WILLEMSEN 09 342 7639 
BAST ROB THOMPSON 07 848 5512 Kal GOORLIE TERRY BURNETT 090.21.5212 
IPSWICH MICK MURPHY 07 27 1777 
NORTH JACK FRICKER 07 262 8869 
PINE RIVERS BARRY CLARKE 07 204 2806 CANADA - CoCo & MODEL 100: 
SOUTH WEST BOB DEVRIES 07 375 3161 Ontario Richard Hobson 416 293 2346 
SANDGATE MARK MIGHELL 07 269 5090 
SCARBOROUGH PETER MAY 07 203 6723 
AIRLIE BEACH GLEN EVANS 079 46 1264 
BIGGENDEN ALAN MENHAM 071 27 1272 
BLACKWATER ANNIE MEIJER 079. 82.6931 
BOWEN TERRY COTTON C/O 077 86 2220 


(Stop between numbers = b.h. else 
a.h.; t+ hyphen between = both.) 





BUSINESS: 
BRIZBIZ BRIAN BERE-STREBTER 07 349 4696 


OS9 GROUPS: 
NATIONAL OS9 USERS’ GROUP 
GRAEME NICHOLS 02 451 2954 
NSW 


SYDNEY 
BANKSTOWN CARL STERN 02 646 3619 
CARLINGFORD ROSKO MCKAY 02 624 3353 


GLADESVILLB MARK ROTHWELL 02 817 4627 
SYDNBY EAST JACKY COCKINOS 02.344.9111 


COOMA FRED BISSELIEG 0648 23263 
QLD 

BRISBANE JACK FRICKER 07 262 8869 
VIC 


LATROBE VLY GEORGE FRANCIS 051 34 5175 
WA 
KALGOORLIE TBRRY BUREETT 090.21.5212 


MC-10 GROUPS: 


GOLD COAST JIM ROGERS 075 91 4239 
LITHGOW DAVID BERGER 063 52 2282 
ORANGE DAVID KEMP 063 62 2270 
PORT LINCOLN BILL BOARDMAN 086 82 2385 
ROCKHAMPTON TIM SHARK 079 28 1846 
SYDNEY RAJA VIJAY 02 519 4106 
WARRNAMBOOL GARY FURR 055 62 7440 

TAHDY 1000 / MS DOS: 

QLD: 

BRISBANE 
NORTH BRIAN DOUGAN 07 30 2072 
SOUTH BARRY CAWLEY 07 390 7946 


GOLD COAST GRAHAM MORPHETT 075 51 0015 
MARYBOUOUGH HORM GREENAWAY 
VIC: 

MELBOURNE TOHY LLOYD 03 882 4664 
HSY: 

GLADESVILLE MARK ROTHWELL 02 817 4627 
SYDNEY WEST ROGER RUTHER 047.39.3903 


WYONG JOHN WALLACE 043 90 0312 
FORTH: 
-BRISBANE JOHN POXON 07 208 7820 
PORT LINCOLN JOHN BOARDMAN 086 82 2385 
SYDNEY JOHN REDMOND 02 85 3751 
ROBOTICS: 
BOWEN TOHY EVANS 077 86 2220 
GOLD COAST GRAHAM MORPHETT 075 51 0015 
TAMWORTH ROBERT WEBB 067 65 7256 


WAGGA WAGGA CES JENKINSON 069 25 2263 


CHRISTIAN USERS’ GROUP: 
COLLIB RAYMOND L. ISAAC 097 34 1578 


300 BAUD BULLETIN BOARDS 


SYDNEY: 

INFOCERTRE 02 344 9511 
TANDY ACCESS 02 625 8071 
THE COCOCONNECTION - 02 618 3591 
DAIL DUBBO (6pm - 8am) 068 82 $011 


1200/75 BAUD TANDY INFORMATION 
VIATEL: 
GOLDLINK 46424 
VTX 4000 03 329 2936 
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